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 | 31ca4db2a05ab7694a66d97ce2e788861534f47d (patch) | |
| tree | bdeec9391aaba5b61d14fc0795b8ec3024ff23f4 /tests/test-org-webclipper-process.el | |
| parent | db0bbc31a53aa00cb50a3e5ec185378e913c6c0c (diff) | |
| download | dotemacs-31ca4db2a05ab7694a66d97ce2e788861534f47d.tar.gz dotemacs-31ca4db2a05ab7694a66d97ce2e788861534f47d.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 'tests/test-org-webclipper-process.el')
0 files changed, 0 insertions, 0 deletions
