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 | 18158d89c6c8dee6913252c1ccf4ac87ec70ea74 (patch) | |
| tree | 66cd6cf186a1d1c08b9e3581c9a67f540de76511 /tests | |
| parent | 13826423b1f69ff602fabf5fff0cdc8d9a80b241 (diff) | |
| download | dotemacs-18158d89c6c8dee6913252c1ccf4ac87ec70ea74.tar.gz dotemacs-18158d89c6c8dee6913252c1ccf4ac87ec70ea74.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')
0 files changed, 0 insertions, 0 deletions