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 | 502bcf41c7258b169d6481676c59c42e0e931e7c (patch) | |
| tree | e895aab48e718aa5106f23da9afb1173dc464257 /CLAUDE.md | |
| parent | 2b19eb175d0664908f76bf7cc8dcc1eb5c140ce1 (diff) | |
| download | dotemacs-502bcf41c7258b169d6481676c59c42e0e931e7c.tar.gz dotemacs-502bcf41c7258b169d6481676c59c42e0e931e7c.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 'CLAUDE.md')
0 files changed, 0 insertions, 0 deletions
