dotemacs/docs/design, branch mainMy Emacs configuration
https://git.cjennings.net/dotemacs/atom?h=main2026-07-10T06:23:31+00:00fix(flycheck): lint ledger buffers, which nothing ever did2026-07-10T06:23:31+00:00Craig Jenningsc@cjennings.net2026-07-10T06:23:31+00:00urn:sha1:55b85754d78f268907ad5fa5be886973bbef921d
flycheck-ledger registers a ledger checker, but a checker only runs where flycheck-mode is on, and flycheck-mode was hooked to sh-mode and emacs-lisp-mode only. There's no global-flycheck-mode. So an unbalanced transaction in a financial file produced no warning at all, while the ledger module's commentary advertised linting.
The hook goes in flycheck-config, not ledger-config, so that list stays the one answer to "where is flycheck turned on?".
Verified on an unbalanced fixture: flycheck now reports "Transaction does not balance" with the $10.00 remainder, on the right line.
I also accepted the whole-buffer sort the audit flagged. ledger-sort-startkey keys on the ISO date alone, and sort-subr is stable, so a save orders by date and leaves same-day transactions where they were typed. The audit note records both.
test(ledger): audit ledger-config and pin its current behavior2026-07-10T05:44:39+00:00Craig Jenningsc@cjennings.net2026-07-10T05:44:39+00:00urn:sha1:621287447f149eb571e00c067e410704c4ebf968
The linting doesn't run. flycheck-ledger loads and registers the ledger checker, but flycheck-mode is hooked to sh-mode and emacs-lisp-mode only, and there's no global-flycheck-mode. I checked a live ledger-mode buffer: checker registered, flycheck-mode nil. Unbalanced transactions and typo'd account names produce no warning, on a financial file, while the module commentary claims linting.
Three smaller findings. Every save reorders the whole file, because ledger-mode-clean-buffer calls ledger-sort-buffer over point-min to point-max. The demoted error around it lets a save proceed after a partial rewrite, with nothing to roll back. Reconcile has no confirmation and clears whole transactions.
Five characterization tests pin what exists now, including the clean-on-save default the audit questions. I fixed nothing: the guardrail choices are a separate task, and only the flycheck gap is a defect rather than a preference.
docs(design): survey where a curated "?" help menu fits2026-07-10T05:38:21+00:00Craig Jenningsc@cjennings.net2026-07-10T05:38:21+00:00urn:sha1:02c2e0ee8e00869681595bd7b80a98219563b39f
The mechanical half of the "?" convention task. I probed ten modes from their live keymaps rather than from source, because a package's define-key calls don't always agree with what lands in the map.
Four modes have both ? and H free, so nov, eat, and the two elfeed modes can adopt the convention without displacing anything. Three bind ? to something small that adopting it would displace. mu4e-headers is the one real conflict: its ? marks mail unread, a state-mutating command in the marking family.
magit already binds ? to its own dispatch. The convention isn't new, it's magit's habit generalized.
I ran the probe in a throwaway batch Emacs rather than the daemon, since probing calibredb and mu4e in a live session would force-load them. mu4e isn't an ELPA package and needed its site-lisp path.
docs(design): map Org module ownership and load boundaries2026-07-10T05:35:28+00:00Craig Jenningsc@cjennings.net2026-07-10T05:35:28+00:00urn:sha1:7f9c44023a89ef47a3a1a76a2ada4d69ba0ad678
Sixteen modules make up the Org workflow, and nothing wrote down which owns what. Answering "who sets this variable?" meant grepping. The note maps each module to its behavior, the shared variables with more than one writer, and the init.el load order.
The load-boundary facts are the useful part. Four modules append to org-capture-templates, four touch org-agenda-files, and five register org-protocol handlers. quick-video-capture loads twenty-four lines before org-config because it's grouped with the media modules. Every Org module loads eagerly, including the five its own headers call optional.
I recorded four follow-ups in the note instead of fixing them: a tracked .bak file under modules/, a missing header on the agenda debug module, no collision check on org-protocol handlers, and that eager loading.
docs: reclassify subr-mock-migration as a design note2026-07-04T22:19:06+00:00Craig Jenningsc@cjennings.net2026-07-04T22:19:06+00:00urn:sha1:48f0bbd7a1894fafd46f1093d5a17300efbba0bbdocs(specs): adopt status-heading lifecycle convention across specs2026-07-04T20:38:00+00:00Craig Jenningsc@cjennings.net2026-07-04T20:38:00+00:00urn:sha1:38200c6683e55860b044568cd70004dcbc7c4031
Migrate 29 legacy specs off the old shape (a status suffix in the filename plus a :STATUS: property drawer) onto the docs-lifecycle status heading: a top-level heading carrying the org lifecycle keyword and a dated history line, with the two #+TODO sequences in the header.
Dropping the -doing/-implemented/-superseded suffixes means a status change no longer forces a rename and link surgery. Each keyword comes from the spec's own recorded status. The four specs already on the heading form are untouched, and every inbound reference now points at the new names.
The status board is one grep: rg '^\* (DRAFT|READY|DOING|IMPLEMENTED|SUPERSEDED|CANCELLED) ' docs/specs/
docs: sort three theme-studio specs into docs/specs with status headings2026-07-02T05:07:33+00:00Craig Jenningsc@cjennings.net2026-07-02T05:07:33+00:00urn:sha1:67e767466ba63e6e673e4157b68d58948a493462
First spec-sort pass under the docs-lifecycle convention: color-families -> READY (its status field carried the 2026-06-10 confirmation), palette-columns and palette-ramps -> DRAFT. Each got the authoritative status heading with an :ID: UUID; six inbound links rewritten. subr-mock-migration-spec is -spec-named but lacks the spec spine, so it stays put until it's renamed or retrofitted.
refactor: prefix two collision-prone helpers, document naming audit2026-06-29T08:19:31+00:00Craig Jenningsc@cjennings.net2026-06-29T08:19:31+00:00urn:sha1:d9763647f85629ffb80ac85b136880ad3b7da627
Two owned helpers carried unprefixed generic names that risk colliding in the single Emacs namespace: car-member (local-repository.el) and unpropertize-kill-ring (system-defaults.el). I renamed them to localrepo--car-member and cj/--unpropertize-kill-ring and updated their callers and tests. Both are non-interactive and contained, so no alias was needed.
docs/design/naming-audit.org records the rest of the scan: the allowlist of deliberate module prefixes, the foreign forward-declarations that aren't owned definitions, and a deferred list (keybound commands, the with-timer macro, the ui-theme defcustoms, the user-constants paths) that each want a focused pass rather than an unattended rename.
docs(term): design for the F12 -> EAT terminal swap2026-06-25T20:07:15+00:00Craig Jenningsc@cjennings.net2026-06-25T20:07:15+00:00urn:sha1:ce8407a1bc79a2f36785d5d8f9b50d948fb9e555docs: add VAMP standalone music-player design2026-06-22T09:06:22+00:00Craig Jenningsc@cjennings.net2026-06-22T09:06:22+00:00urn:sha1:87e5cbc8629f25e75ffcadfa149206261e182005