diff options
| author | Craig Jennings <c@cjennings.net> | 2026-04-26 20:51:03 -0500 |
|---|---|---|
| committer | Craig Jennings <c@cjennings.net> | 2026-04-26 20:51:03 -0500 |
| commit | 74375589a57f9755088174d758ffc50685f98286 (patch) | |
| tree | f9d1e73d7e1bc98a081ccebbf74e125c936a6ef4 /modules | |
| parent | 04d699f9cb68cfcfaf492d01b6ab88e5aca07d37 (diff) | |
| download | dotemacs-74375589a57f9755088174d758ffc50685f98286.tar.gz dotemacs-74375589a57f9755088174d758ffc50685f98286.zip | |
docs(design): add debug-profiling.el module brainstorm output
Captures the agreed v1 shape for a new =debug-profiling.el= module: targeted slow-command investigation, two features ("profile next command" and "time region or sexp"), each split into pure helper plus interactive wrapper. Migrates the existing =profiler-*= bindings and =cj/benchmark-this-method= out of =config-utilities.el=. Stays on the existing =C-c d= debug umbrella prefix.
Six approaches were considered: three conventional, plus three tail samples (macro-first, log-and-grep, treesit picker). Recommendation is the boring named-operation surface backed by a thin wrapper over the built-in =profiler.el= and =benchmark.el=. The other five options are recorded with reasons-rejected so a future reader can see what was weighed.
Design covers architecture, data flow, error handling, testing approach, and observability. Two open questions are parked: default REPS for =cj/time--expr=, and whether to capture =cpu+mem= or just =cpu=. Both are fine to defer until v1 has been used on the queued org-capture target-building investigation.
Implementation will run via =/start-work= against this design.
Diffstat (limited to 'modules')
0 files changed, 0 insertions, 0 deletions
