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 | ebfb6e7028c04e4a1d86b11f51a3f62a20fb0d9b (patch) | |
| tree | ed6552826cc747dc3398abd1d871ec0f857654ed /tests/test-system-lib-executable-find-or-warn.el | |
| parent | 976f9c34790f6365412c2960ebc88ef2635a88e1 (diff) | |
| download | dotemacs-ebfb6e7028c04e4a1d86b11f51a3f62a20fb0d9b.tar.gz dotemacs-ebfb6e7028c04e4a1d86b11f51a3f62a20fb0d9b.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