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 | bb353d9f2a41caa596e4b535514325a46095d111 (patch) | |
| tree | bdeec9391aaba5b61d14fc0795b8ec3024ff23f4 /modules/prog-python.el | |
| parent | 781b46e4eb7c08a3db01b1c1d89677ba8e21fd98 (diff) | |
| download | dotemacs-bb353d9f2a41caa596e4b535514325a46095d111.tar.gz dotemacs-bb353d9f2a41caa596e4b535514325a46095d111.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/prog-python.el')
0 files changed, 0 insertions, 0 deletions
