dotemacs/docs/specs/face-font-diagnostic-popup-spec.org, branch mainMy Emacs configuration
https://git.cjennings.net/dotemacs/atom?h=main2026-07-04T20:38:00+00:00docs(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/
feat(face-diagnostic): Phase 4 render, command, and init wiring2026-06-15T17:37:48+00:00Craig Jenningsc@cjennings.net2026-06-15T17:37:48+00:00urn:sha1:46c39f329979a105a7aec0909d720090aaa0dc33
Phase 4 completes the face/font diagnostic. cj/describe-face-at-point renders cj/--face-diagnosis-at into a read-only *Face Diagnosis* buffer (cj/face-diagnostic-mode), with a region-scan mode over distinct face-runs (capped at 20) and an out-of-scope banner. It is required in init.el. The render is split into small section formatters tested on captured plists, and the command is smoke-tested and live-verified in the daemon, where it already surfaces the active auto-dim remaps. The command name is settled as cj/describe-face-at-point. The keybinding stays Craig's pick, and face-name buttons plus the module-header allowlist entry are filed as a follow-up. The spec is marked implemented and renamed to its lifecycle filename. 35 ERT tests, byte-compile clean.
feat(face-diagnostic): Phase 2 merged attributes and real font2026-06-15T17:27:29+00:00Craig Jenningsc@cjennings.net2026-06-15T17:27:29+00:00urn:sha1:7fa0fac77d4ab0c83e990645f55a262130e4d57d
Extend the diagnostic core with the effective merged attributes and the real-font layer. cj/--face-diag-merged-attributes folds the ordered, remap-expanded spec stack (overlays over text-props over default), taking the first non-unspecified value per attribute, labeled "computed". cj/--face-diag-real-font reports font-at's font, or "unavailable" under batch and on terminals. cj/--face-diagnosis-at now returns groups 0-4. Settles spec decision #7 (the hand-fold approach), pinned by fixtures: overlay-over-text-prop, a default remap, a face-symbol attribute. 23 ERT tests, byte-compile clean.
docs: move specs to docs/specs/ with lifecycle-status filenames2026-06-15T15:24:40+00:00Craig Jenningsc@cjennings.net2026-06-15T15:24:40+00:00urn:sha1:3805128015688f057eefb7cc82a2a0f0ac67bba2
Separate the 27 formal specs from working notes. Specs move to docs/specs/, notes stay in docs/design/. Each spec carries its lifecycle in the filename (-spec, -spec-doing, -spec-implemented, -spec-superseded) plus an authoritative ID and STATUS property drawer. The status came from checking each spec against the code, not the doc's own field: 6 implemented, 8 in progress, 12 not started, 1 superseded.
Inbound links become org-id links so future status renames don't break them; code-comment paths repoint to docs/specs/. Working notes, inventories, reviews, and brainstorms stay in docs/design/.