docs(load-graph): classify text/editing command modules

Second classification batch: the nine custom-* text/editing command helpers (case, comments, datetime, buffer-file, line-paragraph, misc, ordering, text-enclose, whitespace). I annotated each with the load-graph header contract and added a Batch 2 table to the inventory. They're all Layer 2, eager only to register a C-; submap at load, with no necessary eager reason, so all are Phase 3/4 deferral candidates.

The inventory records a second hidden dependency for Phase 2: custom-buffer-file guards its C-; b registration with (when (boundp 'cj/custom-keymap) ...) and declares the keymap only via eval-when-compile, so the binding silently drops when the module loads without keybindings.

9 files changed, 101 insertions, 3 deletions

diff --git a/modules/custom-buffer-file.el b/modules/custom-buffer-file.el
index e3fdedf2..67191244 100644
--- a/modules/custom-buffer-file.el
+++ b/modules/custom-buffer-file.el
@@ -1,6 +1,19 @@
 ;;; custom-buffer-file.el --- Custom Buffer and File Operations -*- coding: utf-8; lexical-binding: t; -*-
 ;;
 ;;; Commentary:
+;;
+;; Layer: 2 (Core UX).
+;; Category: L/C.
+;; Load shape: eager.
+;; Eager reason: registers its C-; b buffer/file submap at load. Currently eager
+;;   by init order; a deferral candidate for Phase 3/4.
+;; Top-level side effects: defines cj/copy-buffer-content-map and
+;;   cj/buffer-and-file-map; conditionally registers the latter under C-; b.
+;; Runtime requires: external-open, mm-decode, system-lib. keybindings is needed
+;;   for the C-; b registration but is declared only via eval-when-compile and
+;;   guarded by `boundp', so the binding silently drops standalone. Phase 2 fix.
+;; Direct test load: conditional (C-; b registration skipped without keybindings).
+;;
 ;; This module provides custom buffer and file operations including PostScript
 ;; printing capabilities.
 ;;
diff --git a/modules/custom-case.el b/modules/custom-case.el
index 3f7ebc4d..d8c60b55 100644
--- a/modules/custom-case.el
+++ b/modules/custom-case.el
@@ -2,6 +2,17 @@
 
 ;;; Commentary:
 ;;
+;; Layer: 2 (Core UX).
+;; Category: L/C.
+;; Load shape: eager.
+;; Eager reason: registers its C-; c case submap at load. Currently eager by
+;;   init order; a deferral candidate for Phase 3/4 (command/autoload +
+;;   registration API).
+;; Top-level side effects: defines cj/case-map, registers it under C-; c, remaps
+;;   capitalize-region.
+;; Runtime requires: keybindings.
+;; Direct test load: yes (requires keybindings explicitly).
+;;
 ;; Utilities for changing text case.
 ;; - cj/title-case-region: Title-cases the active region, or the current line if
 ;;   no region. Follows common English rules: major words capitalized; minor words
diff --git a/modules/custom-comments.el b/modules/custom-comments.el
index 7e8e1404..467e1fd7 100644
--- a/modules/custom-comments.el
+++ b/modules/custom-comments.el
@@ -1,6 +1,17 @@
 ;;; custom-comments.el --- Custom Comment Operations -*- coding: utf-8; lexical-binding: t; -*-
 ;;
 ;;; Commentary:
+;;
+;; Layer: 2 (Core UX).
+;; Category: L/C.
+;; Load shape: eager.
+;; Eager reason: registers its C-; C comment submap at load. Currently eager by
+;;   init order; a deferral candidate for Phase 3/4 (command/autoload +
+;;   registration API).
+;; Top-level side effects: defines cj/comment-map, registers it under C-; C.
+;; Runtime requires: keybindings.
+;; Direct test load: yes (requires keybindings explicitly).
+;;
 ;; This module provides custom comment formatting and manipulation utilities for code editing.
 ;;
 ;; Functions include:
diff --git a/modules/custom-datetime.el b/modules/custom-datetime.el
index 1c5f40f2..3db4d28f 100644
--- a/modules/custom-datetime.el
+++ b/modules/custom-datetime.el
@@ -1,6 +1,17 @@
 ;;; custom-datetime.el ---  -*- coding: utf-8; lexical-binding: t; -*-
 
 ;;; Commentary:
+;;
+;; Layer: 2 (Core UX).
+;; Category: L/C.
+;; Load shape: eager.
+;; Eager reason: registers its C-; d datetime submap at load. Currently eager by
+;;   init order; a deferral candidate for Phase 3/4 (command/autoload +
+;;   registration API).
+;; Top-level side effects: defines cj/datetime-map, registers it under C-; d.
+;; Runtime requires: keybindings.
+;; Direct test load: yes (requires keybindings explicitly).
+;;
 ;; Utilities for inserting date/time stamps in multiple formats.
 ;;
 ;; Interactive commands:
diff --git a/modules/custom-line-paragraph.el b/modules/custom-line-paragraph.el
index 0eb1e2a5..8bbbeadb 100644
--- a/modules/custom-line-paragraph.el
+++ b/modules/custom-line-paragraph.el
@@ -3,6 +3,17 @@
 ;;
 ;;; Commentary:
 ;;
+;; Layer: 2 (Core UX).
+;; Category: L/C.
+;; Load shape: eager.
+;; Eager reason: registers its C-; l line/paragraph submap at load. Currently
+;;   eager by init order; a deferral candidate for Phase 3/4 (command/autoload +
+;;   registration API).
+;; Top-level side effects: defines cj/line-and-paragraph-map, registers it under
+;;   C-; l.
+;; Runtime requires: keybindings (expand-region on demand via declare-function).
+;; Direct test load: yes (requires keybindings explicitly).
+;;
 ;; This module provides the following line and paragraph manipulation utilities:
 ;;
 ;; - joining lines in a region or the current line with the previous one
diff --git a/modules/custom-misc.el b/modules/custom-misc.el
index b612e540..2ab5e779 100644
--- a/modules/custom-misc.el
+++ b/modules/custom-misc.el
@@ -2,6 +2,16 @@
 
 ;;; Commentary:
 ;;
+;; Layer: 2 (Core UX).
+;; Category: L/C.
+;; Load shape: eager.
+;; Eager reason: registers its C-; command bindings and an align-regexp advice
+;;   at load. Currently eager by init order; a deferral candidate for Phase 3/4.
+;; Top-level side effects: advises align-regexp; binds several commands directly
+;;   under C-; (")", "f", "A", "SPC", "|", and others).
+;; Runtime requires: keybindings.
+;; Direct test load: yes (requires keybindings explicitly).
+;;
 ;; This module provides various utility functions for text manipulation,
 ;; formatting, and navigation.  Features include:
 ;; - Jump between matching delimiters
diff --git a/modules/custom-ordering.el b/modules/custom-ordering.el
index ee2f2023..6536039e 100644
--- a/modules/custom-ordering.el
+++ b/modules/custom-ordering.el
@@ -1,7 +1,18 @@
 ;;; custom-ordering.el ---  -*- coding: utf-8; lexical-binding: t; -*-
 
 ;;; Commentary:
-
+;;
+;; Layer: 2 (Core UX).
+;; Category: L/C.
+;; Load shape: eager.
+;; Eager reason: registers its C-; o ordering submap at load. Currently eager by
+;;   init order; a deferral candidate for Phase 3/4 (command/autoload +
+;;   registration API).
+;; Top-level side effects: defines cj/ordering-map, registers it under C-; o.
+;; Runtime requires: cl-lib, keybindings (org-config on demand via
+;;   declare-function).
+;; Direct test load: yes (requires keybindings explicitly).
+;;
 ;; Text transformation and sorting utilities for reformatting data structures.
 ;;
 ;; Array/list formatting:
diff --git a/modules/custom-text-enclose.el b/modules/custom-text-enclose.el
index e23674ff..cbae2990 100644
--- a/modules/custom-text-enclose.el
+++ b/modules/custom-text-enclose.el
@@ -1,7 +1,17 @@
 ;;; custom-text-enclose.el ---  -*- coding: utf-8; lexical-binding: t; -*-
 
 ;;; Commentary:
-
+;;
+;; Layer: 2 (Core UX).
+;; Category: L/C.
+;; Load shape: eager.
+;; Eager reason: registers its C-; s enclose submap at load. Currently eager by
+;;   init order; a deferral candidate for Phase 3/4 (command/autoload +
+;;   registration API).
+;; Top-level side effects: defines cj/enclose-map, registers it under C-; s.
+;; Runtime requires: keybindings (change-inner on demand via declare-function).
+;; Direct test load: yes (requires keybindings explicitly).
+;;
 ;; Text enclosure utilities for wrapping and line manipulation.
 ;;
 ;; Wrapping functions:
diff --git a/modules/custom-whitespace.el b/modules/custom-whitespace.el
index 622ba5f4..19e2e020 100644
--- a/modules/custom-whitespace.el
+++ b/modules/custom-whitespace.el
@@ -1,7 +1,17 @@
 ;;; custom-whitespace.el ---  -*- coding: utf-8; lexical-binding: t; -*-
 
 ;;; Commentary:
-
+;;
+;; Layer: 2 (Core UX).
+;; Category: L/C.
+;; Load shape: eager.
+;; Eager reason: registers its C-; w whitespace submap at load. Currently eager
+;;   by init order; a deferral candidate for Phase 3/4 (command/autoload +
+;;   registration API).
+;; Top-level side effects: defines cj/whitespace-map, registers it under C-; w.
+;; Runtime requires: keybindings.
+;; Direct test load: yes (requires keybindings explicitly).
+;;
 ;; This module provides whitespace manipulation operations for cleaning and transforming whitespace in text.
 
 ;; Functions include: