diff options
| author | Craig Jennings <c@cjennings.net> | 2026-05-10 14:00:07 -0500 |
|---|---|---|
| committer | Craig Jennings <c@cjennings.net> | 2026-05-10 14:00:07 -0500 |
| commit | 794585b8e38025d4a5d359d284663e10c3755ac2 (patch) | |
| tree | e895aab48e718aa5106f23da9afb1173dc464257 /tests/test-system-lib-executable-find-or-warn.el | |
| parent | b361e35aa2a33a6050bd42678a7e520b2c44395e (diff) | |
| download | dotemacs-794585b8e38025d4a5d359d284663e10c3755ac2.tar.gz dotemacs-794585b8e38025d4a5d359d284663e10c3755ac2.zip | |
docs(design): add Phase 1 utility inventory
Phase 1 of utility-consolidation per docs/design/utility-consolidation.org. The inventory walks the spec's 30-entry Candidate Extraction Table and, for each helper, records: visibility, dependencies, side effects, callers in modules and tests, test file location, extraction priority, and a Migrate / Leave / Defer decision with rationale.
Decisions: 11 Migrate, 3 Leave, 13 Defer. The Migrate items are grouped by phase in the spec's recommended order: Phase 2 (foundation helpers -- executable lookup, shell quoting, process runner, file-from-context), Phase 3 (Org-safe text sanitizers), Phase 4 (external-open consolidation). The Defer items mostly need a second production caller before promotion is justified.
Discoveries worth recording: `cj/log-silently' already has 10 production callers (more than the spec's table suggested), and `cj/--file-manager-program-for' shipped today in dirvish-config.el is the new form of OS-dispatch consolidation -- Phase 4's `cj/external-open-command' should fold it in rather than re-deriving.
No code behavior changes -- this is the spec's stated Phase 1 exit criterion.
Diffstat (limited to 'tests/test-system-lib-executable-find-or-warn.el')
0 files changed, 0 insertions, 0 deletions