diff options
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/design/signal-client-review.org | 2 | ||||
| -rw-r--r-- | docs/design/utility-inventory.org | 6 | ||||
| -rw-r--r-- | docs/specs/ai-kb-spec.org | 12 | ||||
| -rw-r--r-- | docs/specs/ai-vterm-spec.org (renamed from docs/specs/ai-vterm-spec-superseded.org) | 12 | ||||
| -rw-r--r-- | docs/specs/cache-helper-design-spec.org (renamed from docs/specs/cache-helper-design-spec-implemented.org) | 14 | ||||
| -rw-r--r-- | docs/specs/company-to-corfu-migration-spec.org | 12 | ||||
| -rw-r--r-- | docs/specs/coverage-spec.org (renamed from docs/specs/coverage-spec-implemented.org) | 12 | ||||
| -rw-r--r-- | docs/specs/debug-profiling-spec.org | 12 | ||||
| -rw-r--r-- | docs/specs/dev-setup-project-spec.org | 12 | ||||
| -rw-r--r-- | docs/specs/dupre-clear-theme-spec.org | 12 | ||||
| -rw-r--r-- | docs/specs/face-font-diagnostic-popup-spec.org (renamed from docs/specs/face-font-diagnostic-popup-spec-implemented.org) | 13 | ||||
| -rw-r--r-- | docs/specs/flycheck-modeline-customization-spec.org (renamed from docs/specs/flycheck-modeline-customization-spec-implemented.org) | 12 | ||||
| -rw-r--r-- | docs/specs/gloss-spec.org (renamed from docs/specs/gloss-spec-doing.org) | 11 | ||||
| -rw-r--r-- | docs/specs/google-keep-emacs-integration-spec.org | 9 | ||||
| -rw-r--r-- | docs/specs/init-load-graph-spec.org (renamed from docs/specs/init-load-graph-spec-doing.org) | 20 | ||||
| -rw-r--r-- | docs/specs/keybinding-console-safety-spec.org (renamed from docs/specs/keybinding-console-safety-spec-doing.org) | 14 | ||||
| -rw-r--r-- | docs/specs/messenger-unification-spec.org | 13 | ||||
| -rw-r--r-- | docs/specs/music-config-without-emms-spec.org | 12 | ||||
| -rw-r--r-- | docs/specs/org-faces-spec.org (renamed from docs/specs/org-faces-spec-implemented.org) | 13 | ||||
| -rw-r--r-- | docs/specs/signal-client-spec.org (renamed from docs/specs/signal-client-spec-doing.org) | 11 | ||||
| -rw-r--r-- | docs/specs/theme-studio-completion-preview-spec.org | 11 | ||||
| -rw-r--r-- | docs/specs/theme-studio-nerd-icons-colors-spec.org | 9 | ||||
| -rw-r--r-- | docs/specs/theme-studio-package-faces-spec.org (renamed from docs/specs/theme-studio-package-faces-spec-doing.org) | 12 | ||||
| -rw-r--r-- | docs/specs/theme-studio-palette-generator-spec.org (renamed from docs/specs/theme-studio-palette-generator-spec-doing.org) | 13 | ||||
| -rw-r--r-- | docs/specs/theme-studio-perceptual-color-metrics-spec.org (renamed from docs/specs/theme-studio-perceptual-color-metrics-spec-implemented.org) | 12 | ||||
| -rw-r--r-- | docs/specs/theme-studio-preview-locate-spec.org | 13 | ||||
| -rw-r--r-- | docs/specs/theme-studio-seeding-engine-spec.org (renamed from docs/specs/theme-studio-seeding-engine-spec-doing.org) | 14 | ||||
| -rw-r--r-- | docs/specs/theme-studio-semantic-theme-architecture-spec.org | 15 | ||||
| -rw-r--r-- | docs/specs/theme-studio-structured-output-spec.org | 13 | ||||
| -rw-r--r-- | docs/specs/utility-consolidation-spec.org (renamed from docs/specs/utility-consolidation-spec-doing.org) | 20 | ||||
| -rw-r--r-- | docs/specs/vterm-to-ghostel-migration-spec.org (renamed from docs/specs/vterm-to-ghostel-migration-spec-implemented.org) | 14 |
31 files changed, 248 insertions, 132 deletions
diff --git a/docs/design/signal-client-review.org b/docs/design/signal-client-review.org index 7e8a73e9..e1ac462e 100644 --- a/docs/design/signal-client-review.org +++ b/docs/design/signal-client-review.org @@ -5,7 +5,7 @@ * Scope reviewed - =.ai/workflows/spec-review.org=. -- =docs/specs/signal-client-spec-doing.org=, including the base design, open-question dispositions, initiate-message workflow, architecture additions, accepted caveats, test plan, scope summary, and readiness rubric. +- =docs/specs/signal-client-spec.org=, including the base design, open-question dispositions, initiate-message workflow, architecture additions, accepted caveats, test plan, scope summary, and readiness rubric. - =modules/signal-config.el=, including =cj/signal--parse-contacts=, notify-suppression helpers, private config loading, and current =use-package signel= wiring. - =~/code/signel/signel.el=, including =signel-start=, =signel--send-rpc=, =signel--dispatch=, =signel--handle-error=, =signel--handle-receive=, =signel--insert-msg=, =signel--insert-system-msg=, =signel--send-input=, =signel-chat=, and dashboard commands. - =tests/test-signal-config.el=, covering contact parsing and notify-suppression helpers. diff --git a/docs/design/utility-inventory.org b/docs/design/utility-inventory.org index 8438a592..9b811429 100644 --- a/docs/design/utility-inventory.org +++ b/docs/design/utility-inventory.org @@ -4,7 +4,7 @@ * Status -Living inventory. Phase 1 of [[id:fc2e3926-b4a1-4b45-92eb-20841e13f655][utility-consolidation-spec-doing.org]]. Records the current state of helpers identified in the spec's Candidate Extraction Table plus any new candidates discovered during module walkthroughs. Decisions become concrete tasks in =todo.org= for Phase 2+. +Living inventory. Phase 1 of [[id:fc2e3926-b4a1-4b45-92eb-20841e13f655][utility-consolidation-spec.org]]. Records the current state of helpers identified in the spec's Candidate Extraction Table plus any new candidates discovered during module walkthroughs. Decisions become concrete tasks in =todo.org= for Phase 2+. * Scope @@ -82,7 +82,7 @@ Caller counts in the inventory below reflect grep results from 2026-05-10. The c | Symbol | File | Vis | Deps | Side effects | Proposed home / name | Callers (modules) | Tests | Pri | Decision | Rationale | |--------+------+-----+------+--------------+----------------------+-------------------+-------+-----+----------+-----------| -| =cj/modeline-vc-cache-*= helpers (key/get/put/clear/valid-p) | =modeline-config.el:108-140= | private | buffer-local vars | mutates buffer-local state | =cj-cache.el= / =cj/cache-valid-p=, =cj/cache-get=, =cj/cache-put=, =cj/cache-clear= | 1 (within file) | =test-modeline-config-vc-cache.el= | Medium | Defer | Good pattern, but variable-local cache shape differs from the agenda/refile caches. Needs design before extraction. Spec calls out a Phase 5 design addendum at =docs/specs/cache-helper-design-spec-implemented.org=. | +| =cj/modeline-vc-cache-*= helpers (key/get/put/clear/valid-p) | =modeline-config.el:108-140= | private | buffer-local vars | mutates buffer-local state | =cj-cache.el= / =cj/cache-valid-p=, =cj/cache-get=, =cj/cache-put=, =cj/cache-clear= | 1 (within file) | =test-modeline-config-vc-cache.el= | Medium | Defer | Good pattern, but variable-local cache shape differs from the agenda/refile caches. Needs design before extraction. Spec calls out a Phase 5 design addendum at =docs/specs/cache-helper-design-spec.org=. | | agenda/refile cache vars and build flags | =org-agenda-config.el=, =org-refile-config.el= | n/a | timers, file scans | scans filesystem, sets vars | =cj-cache.el= / =cj/cache-value-or-rebuild= | 2 | none | Medium | Defer | TTL/build/invalidate lifecycle; higher risk than the modeline cache. Same Phase 5 work. | ** Logging / Warnings @@ -144,7 +144,7 @@ These become =todo.org= entries (or update existing ones) as Phase 2 starts. ** Deferred (track in =todo.org= but no commit yet) -- Cache abstraction (modeline + agenda/refile) -- needs Phase 5 design addendum at =docs/specs/cache-helper-design-spec-implemented.org=. +- Cache abstraction (modeline + agenda/refile) -- needs Phase 5 design addendum at =docs/specs/cache-helper-design-spec.org=. - =cj/--open-with-is-launcher-p= -- move when external-open ownership is finalized. - =cj/log-silently= rename -- low value; do during incidental =system-lib= work. - HTML/text helpers (=strip-html=, =clean-text=) -- defer until a second consumer. diff --git a/docs/specs/ai-kb-spec.org b/docs/specs/ai-kb-spec.org index fbd35ca5..b35b3ac6 100644 --- a/docs/specs/ai-kb-spec.org +++ b/docs/specs/ai-kb-spec.org @@ -1,11 +1,15 @@ -:PROPERTIES: -:ID: 03742426-35ce-41c5-aed7-d4e248e91833 -:STATUS: not-started -:END: #+TITLE: Design: AI Knowledge Base (ai-kb) #+AUTHOR: Craig Jennings #+DATE: 2026-05-24 #+OPTIONS: toc:nil num:nil +#+TODO: TODO | DONE +#+TODO: DRAFT READY DOING | IMPLEMENTED SUPERSEDED CANCELLED + +* DRAFT Design: AI Knowledge Base (ai-kb) +:PROPERTIES: +:ID: 03742426-35ce-41c5-aed7-d4e248e91833 +:END: +- 2026-07-04 Sat @ 15:30:41 -0500 — retrofitted to status-heading convention; keyword DRAFT from existing :STATUS: not-started * Status diff --git a/docs/specs/ai-vterm-spec-superseded.org b/docs/specs/ai-vterm-spec.org index 0b6bfb86..7015a862 100644 --- a/docs/specs/ai-vterm-spec-superseded.org +++ b/docs/specs/ai-vterm-spec.org @@ -1,11 +1,15 @@ -:PROPERTIES: -:ID: 3abd0270-e87c-42b7-9b3a-ef60300db99d -:STATUS: superseded -:END: #+TITLE: Design: ai-vterm — in-Emacs Claude launcher #+AUTHOR: Craig Jennings #+DATE: 2026-05-07 #+OPTIONS: toc:nil num:nil +#+TODO: TODO | DONE +#+TODO: DRAFT READY DOING | IMPLEMENTED SUPERSEDED CANCELLED + +* SUPERSEDED Design: ai-vterm — in-Emacs Claude launcher +:PROPERTIES: +:ID: 3abd0270-e87c-42b7-9b3a-ef60300db99d +:END: +- 2026-07-04 Sat @ 15:30:41 -0500 — retrofitted to status-heading convention; keyword SUPERSEDED from existing :STATUS: superseded + -superseded filename (Craig's prior determination) * Status diff --git a/docs/specs/cache-helper-design-spec-implemented.org b/docs/specs/cache-helper-design-spec.org index 27c818dc..5bfb661b 100644 --- a/docs/specs/cache-helper-design-spec-implemented.org +++ b/docs/specs/cache-helper-design-spec.org @@ -1,14 +1,18 @@ -:PROPERTIES: -:ID: 647c5101-21c2-47bb-aaa7-72c757f45fb7 -:STATUS: implemented -:END: #+TITLE: Cache Helper Design Addendum #+AUTHOR: Craig Jennings #+DATE: 2026-05-10 +#+TODO: TODO | DONE +#+TODO: DRAFT READY DOING | IMPLEMENTED SUPERSEDED CANCELLED + +* IMPLEMENTED Cache Helper Design Addendum +:PROPERTIES: +:ID: 647c5101-21c2-47bb-aaa7-72c757f45fb7 +:END: +- 2026-07-04 Sat @ 15:30:41 -0500 — retrofitted to status-heading convention; keyword IMPLEMENTED from existing :STATUS: implemented + -implemented filename (Craig's prior determination) * Status -Phase 5 design addendum to [[id:fc2e3926-b4a1-4b45-92eb-20841e13f655][utility-consolidation-spec-doing.org]]. Specifies the cache API to extract before any code moves. +Phase 5 design addendum to [[id:fc2e3926-b4a1-4b45-92eb-20841e13f655][utility-consolidation-spec.org]]. Specifies the cache API to extract before any code moves. * Problem diff --git a/docs/specs/company-to-corfu-migration-spec.org b/docs/specs/company-to-corfu-migration-spec.org index a7b059a3..ef094937 100644 --- a/docs/specs/company-to-corfu-migration-spec.org +++ b/docs/specs/company-to-corfu-migration-spec.org @@ -1,11 +1,15 @@ -:PROPERTIES: -:ID: 68733ba2-37a7-4a7b-bfaa-b845d82ff1e7 -:STATUS: not-started -:END: #+TITLE: Design: Migrate from Company to Corfu (with prescient integration) #+AUTHOR: Craig Jennings #+DATE: 2026-05-15 #+OPTIONS: toc:nil num:nil +#+TODO: TODO | DONE +#+TODO: DRAFT READY DOING | IMPLEMENTED SUPERSEDED CANCELLED + +* DRAFT Design: Migrate from Company to Corfu (with prescient integration) +:PROPERTIES: +:ID: 68733ba2-37a7-4a7b-bfaa-b845d82ff1e7 +:END: +- 2026-07-04 Sat @ 15:30:41 -0500 — retrofitted to status-heading convention; keyword DRAFT from existing :STATUS: not-started * Status diff --git a/docs/specs/coverage-spec-implemented.org b/docs/specs/coverage-spec.org index 65734fb3..e2ac4b3c 100644 --- a/docs/specs/coverage-spec-implemented.org +++ b/docs/specs/coverage-spec.org @@ -1,10 +1,14 @@ -:PROPERTIES: -:ID: 7d7f4486-fad7-4f0a-bd9a-775bd4cd8f7e -:STATUS: implemented -:END: #+TITLE: Design: Coverage Reporting #+AUTHOR: Craig Jennings #+DATE: 2026-04-22 +#+TODO: TODO | DONE +#+TODO: DRAFT READY DOING | IMPLEMENTED SUPERSEDED CANCELLED + +* IMPLEMENTED Design: Coverage Reporting +:PROPERTIES: +:ID: 7d7f4486-fad7-4f0a-bd9a-775bd4cd8f7e +:END: +- 2026-07-04 Sat @ 15:30:41 -0500 — retrofitted to status-heading convention; keyword IMPLEMENTED from existing :STATUS: implemented + -implemented filename (Craig's prior determination) * Status diff --git a/docs/specs/debug-profiling-spec.org b/docs/specs/debug-profiling-spec.org index 5961071b..3492d3a2 100644 --- a/docs/specs/debug-profiling-spec.org +++ b/docs/specs/debug-profiling-spec.org @@ -1,10 +1,14 @@ -:PROPERTIES: -:ID: c713b431-ae14-498d-aba9-b84d52f981b6 -:STATUS: not-started -:END: #+TITLE: Design: debug-profiling.el module #+AUTHOR: Craig Jennings #+DATE: 2026-04-26 +#+TODO: TODO | DONE +#+TODO: DRAFT READY DOING | IMPLEMENTED SUPERSEDED CANCELLED + +* DRAFT Design: debug-profiling.el module +:PROPERTIES: +:ID: c713b431-ae14-498d-aba9-b84d52f981b6 +:END: +- 2026-07-04 Sat @ 15:30:41 -0500 — retrofitted to status-heading convention; keyword DRAFT from existing :STATUS: not-started * Status diff --git a/docs/specs/dev-setup-project-spec.org b/docs/specs/dev-setup-project-spec.org index 5d64f368..058784a5 100644 --- a/docs/specs/dev-setup-project-spec.org +++ b/docs/specs/dev-setup-project-spec.org @@ -1,10 +1,14 @@ -:PROPERTIES: -:ID: 596fce5d-1bab-46e7-8567-d4a2e0923091 -:STATUS: not-started -:END: #+TITLE: Design: cj/dev-setup-project #+AUTHOR: Craig Jennings #+DATE: 2026-04-22 +#+TODO: TODO | DONE +#+TODO: DRAFT READY DOING | IMPLEMENTED SUPERSEDED CANCELLED + +* DRAFT Design: cj/dev-setup-project +:PROPERTIES: +:ID: 596fce5d-1bab-46e7-8567-d4a2e0923091 +:END: +- 2026-07-04 Sat @ 15:30:41 -0500 — retrofitted to status-heading convention; keyword DRAFT from existing :STATUS: not-started * Status diff --git a/docs/specs/dupre-clear-theme-spec.org b/docs/specs/dupre-clear-theme-spec.org index 578eb240..8027ee2a 100644 --- a/docs/specs/dupre-clear-theme-spec.org +++ b/docs/specs/dupre-clear-theme-spec.org @@ -1,10 +1,14 @@ -:PROPERTIES: -:ID: 20df7f50-4759-47ba-9782-8dd25a2e173e -:STATUS: not-started -:END: #+TITLE: dupre-clear — a contrast-first AAA sibling theme #+AUTHOR: Craig Jennings #+DATE: 2026-06-07 +#+TODO: TODO | DONE +#+TODO: DRAFT READY DOING | IMPLEMENTED SUPERSEDED CANCELLED + +* DRAFT dupre-clear — a contrast-first AAA sibling theme +:PROPERTIES: +:ID: 20df7f50-4759-47ba-9782-8dd25a2e173e +:END: +- 2026-07-04 Sat @ 15:30:41 -0500 — retrofitted to status-heading convention; keyword DRAFT from existing :STATUS: not-started * Status diff --git a/docs/specs/face-font-diagnostic-popup-spec-implemented.org b/docs/specs/face-font-diagnostic-popup-spec.org index 3e8fadcd..aae355f9 100644 --- a/docs/specs/face-font-diagnostic-popup-spec-implemented.org +++ b/docs/specs/face-font-diagnostic-popup-spec.org @@ -1,11 +1,14 @@ -:PROPERTIES: -:ID: 98f065cf-8bd5-46a0-ac24-da94d66855ad -:STATUS: implemented -:END: #+TITLE: Face and Font Diagnostic Popup — Spec #+AUTHOR: Craig Jennings #+DATE: 2026-06-14 -#+TODO: TODO | DONE SUPERSEDED CANCELLED +#+TODO: TODO | DONE +#+TODO: DRAFT READY DOING | IMPLEMENTED SUPERSEDED CANCELLED + +* IMPLEMENTED Face and Font Diagnostic Popup — Spec +:PROPERTIES: +:ID: 98f065cf-8bd5-46a0-ac24-da94d66855ad +:END: +- 2026-07-04 Sat @ 15:30:41 -0500 — retrofitted to status-heading convention; keyword IMPLEMENTED from existing :STATUS: implemented + -implemented filename (Craig's prior determination) * Metadata diff --git a/docs/specs/flycheck-modeline-customization-spec-implemented.org b/docs/specs/flycheck-modeline-customization-spec.org index 59567be6..2a58b447 100644 --- a/docs/specs/flycheck-modeline-customization-spec-implemented.org +++ b/docs/specs/flycheck-modeline-customization-spec.org @@ -1,11 +1,15 @@ -:PROPERTIES: -:ID: 76979608-956e-474f-90a8-8d0c958101a0 -:STATUS: implemented -:END: #+TITLE: Design: Flycheck modeline customization #+AUTHOR: Craig Jennings #+DATE: 2026-05-15 #+OPTIONS: toc:nil num:nil +#+TODO: TODO | DONE +#+TODO: DRAFT READY DOING | IMPLEMENTED SUPERSEDED CANCELLED + +* IMPLEMENTED Design: Flycheck modeline customization +:PROPERTIES: +:ID: 76979608-956e-474f-90a8-8d0c958101a0 +:END: +- 2026-07-04 Sat @ 15:30:41 -0500 — retrofitted to status-heading convention; keyword IMPLEMENTED from existing :STATUS: implemented + -implemented filename (Craig's prior determination) * Status diff --git a/docs/specs/gloss-spec-doing.org b/docs/specs/gloss-spec.org index 320b83eb..06a7bf50 100644 --- a/docs/specs/gloss-spec-doing.org +++ b/docs/specs/gloss-spec.org @@ -1,10 +1,13 @@ +#+TITLE: Design — gloss (Glossary Lookup with Online-Sourced Selection) +#+DATE: 2026-04-28 +#+TODO: TODO | DONE +#+TODO: DRAFT READY DOING | IMPLEMENTED SUPERSEDED CANCELLED + +* DOING Design — gloss (Glossary Lookup with Online-Sourced Selection) :PROPERTIES: :ID: 295f9969-ccef-4df9-945b-9e08d8069daf -:STATUS: doing :END: -#+TITLE: Design — gloss (Glossary Lookup with Online-Sourced Selection) -#+DATE: 2026-04-28 -#+STATUS: Draft +- 2026-07-04 Sat @ 15:30:41 -0500 — retrofitted to status-heading convention; keyword DOING from existing :STATUS: doing * Problem diff --git a/docs/specs/google-keep-emacs-integration-spec.org b/docs/specs/google-keep-emacs-integration-spec.org index 376522ab..96fd83e5 100644 --- a/docs/specs/google-keep-emacs-integration-spec.org +++ b/docs/specs/google-keep-emacs-integration-spec.org @@ -1,7 +1,14 @@ #+TITLE: Google Keep <-> Emacs integration — Spec #+AUTHOR: Craig Jennings & Claude #+DATE: 2026-06-24 -#+TODO: TODO | DONE SUPERSEDED CANCELLED +#+TODO: TODO | DONE +#+TODO: DRAFT READY DOING | IMPLEMENTED SUPERSEDED CANCELLED + +* DOING Google Keep <-> Emacs integration — Spec +:PROPERTIES: +:ID: 4c796fb9-1d3e-42a9-9b76-eb286eee8732 +:END: +- 2026-07-04 Sat @ 15:30:41 -0500 — retrofitted to status-heading convention; keyword DOING from Metadata Status: v1 implemented, v2 next -> work ongoing * Metadata | Status | v1 implemented (Phases 1-3); live setup pending; v2 next | diff --git a/docs/specs/init-load-graph-spec-doing.org b/docs/specs/init-load-graph-spec.org index 05dd9e0a..0feebfc9 100644 --- a/docs/specs/init-load-graph-spec-doing.org +++ b/docs/specs/init-load-graph-spec.org @@ -1,10 +1,14 @@ -:PROPERTIES: -:ID: e1fd137e-e164-42f4-a658-f4d32fbe3228 -:STATUS: doing -:END: #+TITLE: Design: Untangle the init.el Load Graph #+AUTHOR: Craig Jennings #+DATE: 2026-05-04 +#+TODO: TODO | DONE +#+TODO: DRAFT READY DOING | IMPLEMENTED SUPERSEDED CANCELLED + +* DOING Design: Untangle the init.el Load Graph +:PROPERTIES: +:ID: e1fd137e-e164-42f4-a658-f4d32fbe3228 +:END: +- 2026-07-04 Sat @ 15:30:41 -0500 — retrofitted to status-heading convention; keyword DOING from existing :STATUS: doing * Status @@ -178,7 +182,7 @@ Foundation modules should be able to load in batch mode without package, network, timer, or UI-package side effects. Adding a new Layer 1 module requires a coordinated update to the -=system-lib.el= dependency budget in [[id:fc2e3926-b4a1-4b45-92eb-20841e13f655][utility-consolidation-spec-doing.org]]. +=system-lib.el= dependency budget in [[id:fc2e3926-b4a1-4b45-92eb-20841e13f655][utility-consolidation-spec.org]]. Topic libraries introduced by the utility project join Layer 1 only when their first consumer is foundation-eager. Otherwise they are Layer 2 and loaded by an @@ -395,7 +399,7 @@ Worked example: ;; Runtime requires: user-constants, seq, subr-x. ;; Direct test load: yes (batch-safe; private config is optional). ;; -;; See also: docs/specs/init-load-graph-spec-doing.org, tests/test-calendar-sync.el. +;; See also: docs/specs/init-load-graph-spec.org, tests/test-calendar-sync.el. ;; ;;; Code: #+end_src @@ -452,7 +456,7 @@ Inventory rules: - Every module required by =init.el= must be represented before Phase 2 starts. - Discoveries during later phases update the inventory. - This inventory is independent from the helper inventory owned by - [[id:fc2e3926-b4a1-4b45-92eb-20841e13f655][utility-consolidation-spec-doing.org]]. + [[id:fc2e3926-b4a1-4b45-92eb-20841e13f655][utility-consolidation-spec.org]]. Exit criteria: @@ -647,7 +651,7 @@ rollback shapes. This sibling project can run beside Phase 2. When explicit-dependency work finds a generic duplicated helper, the sibling project owns the extraction commit when the helper is in scope for that project. See -[[id:fc2e3926-b4a1-4b45-92eb-20841e13f655][utility-consolidation-spec-doing.org]] for candidate +[[id:fc2e3926-b4a1-4b45-92eb-20841e13f655][utility-consolidation-spec.org]] for candidate helpers, naming rules, dependency budgets, migration phases, and test policy. * Testing Strategy diff --git a/docs/specs/keybinding-console-safety-spec-doing.org b/docs/specs/keybinding-console-safety-spec.org index 4a1dec81..c7d1baf7 100644 --- a/docs/specs/keybinding-console-safety-spec-doing.org +++ b/docs/specs/keybinding-console-safety-spec.org @@ -1,10 +1,14 @@ -:PROPERTIES: -:ID: 540bf06b-16b8-46c6-b459-c40d1b9c795d -:STATUS: doing -:END: #+TITLE: Keymap Consolidation — Spec #+AUTHOR: Craig Jennings #+DATE: 2026-06-12 +#+TODO: TODO | DONE +#+TODO: DRAFT READY DOING | IMPLEMENTED SUPERSEDED CANCELLED + +* DOING Keymap Consolidation — Spec +:PROPERTIES: +:ID: 540bf06b-16b8-46c6-b459-c40d1b9c795d +:END: +- 2026-07-04 Sat @ 15:30:41 -0500 — retrofitted to status-heading convention; keyword DOING from existing :STATUS: doing * Metadata | Status | doing | @@ -894,7 +898,7 @@ translation block being retired). =C-l= appears only minibuffer-local in - Why: a touched key family broke in GUI and is dead in console; the fix path is cross-cutting (18 keys, a translation layer to retire, a console-safety architecture) with real trade-offs, so it clears the spec bar. -- Artifacts: docs/specs/keybinding-console-safety-spec-doing.org; supersedes the +- Artifacts: docs/specs/keybinding-console-safety-spec.org; supersedes the pre-template draft docs/design/keybinding-console-safety.org. ** 2026-06-12 Fri @ 18:30:30 -0500 — Craig Jennings — review response - What: processed Craig's four review comments. Recorded his first-choice diff --git a/docs/specs/messenger-unification-spec.org b/docs/specs/messenger-unification-spec.org index 92985f59..c92ba1a7 100644 --- a/docs/specs/messenger-unification-spec.org +++ b/docs/specs/messenger-unification-spec.org @@ -1,11 +1,14 @@ -:PROPERTIES: -:ID: 4bfc2011-8ffc-4765-8886-91df12141171 -:STATUS: not-started -:END: #+TITLE: Messenger Unification — Shared Window Placement and Key Conventions #+AUTHOR: Craig Jennings & Claude #+DATE: 2026-06-11 -#+STATUS: Draft — decisions 1-9 settled (Craig, 2026-06-11/12); held open for further ideas before Ready +#+TODO: TODO | DONE +#+TODO: DRAFT READY DOING | IMPLEMENTED SUPERSEDED CANCELLED + +* DRAFT Messenger Unification — Shared Window Placement and Key Conventions +:PROPERTIES: +:ID: 4bfc2011-8ffc-4765-8886-91df12141171 +:END: +- 2026-07-04 Sat @ 15:30:41 -0500 — retrofitted to status-heading convention; keyword DRAFT from existing :STATUS: not-started (held open for more ideas) * Problem diff --git a/docs/specs/music-config-without-emms-spec.org b/docs/specs/music-config-without-emms-spec.org index 32fd6736..c63706e5 100644 --- a/docs/specs/music-config-without-emms-spec.org +++ b/docs/specs/music-config-without-emms-spec.org @@ -1,10 +1,14 @@ -:PROPERTIES: -:ID: 423bc355-18d3-4e39-9e7a-f768b865d95b -:STATUS: not-started -:END: #+TITLE: Design: music-config Without EMMS #+AUTHOR: Craig Jennings #+DATE: 2026-05-15 +#+TODO: TODO | DONE +#+TODO: DRAFT READY DOING | IMPLEMENTED SUPERSEDED CANCELLED + +* DRAFT Design: music-config Without EMMS +:PROPERTIES: +:ID: 423bc355-18d3-4e39-9e7a-f768b865d95b +:END: +- 2026-07-04 Sat @ 15:30:41 -0500 — retrofitted to status-heading convention; keyword DRAFT from existing :STATUS: not-started * Status diff --git a/docs/specs/org-faces-spec-implemented.org b/docs/specs/org-faces-spec.org index c8855906..94fe7bb4 100644 --- a/docs/specs/org-faces-spec-implemented.org +++ b/docs/specs/org-faces-spec.org @@ -1,11 +1,14 @@ -:PROPERTIES: -:ID: 35578114-8c29-43af-97a2-fdfea01a802e -:STATUS: implemented -:END: #+TITLE: Org Header-Row Faces — Spec #+AUTHOR: Craig Jennings #+DATE: 2026-06-15 -#+TODO: TODO | DONE SUPERSEDED CANCELLED +#+TODO: TODO | DONE +#+TODO: DRAFT READY DOING | IMPLEMENTED SUPERSEDED CANCELLED + +* IMPLEMENTED Org Header-Row Faces — Spec +:PROPERTIES: +:ID: 35578114-8c29-43af-97a2-fdfea01a802e +:END: +- 2026-07-04 Sat @ 15:30:41 -0500 — retrofitted to status-heading convention; keyword IMPLEMENTED from existing :STATUS: implemented + -implemented filename (Craig's prior determination) * Metadata | Status | implemented | diff --git a/docs/specs/signal-client-spec-doing.org b/docs/specs/signal-client-spec.org index beee0acf..13f67115 100644 --- a/docs/specs/signal-client-spec-doing.org +++ b/docs/specs/signal-client-spec.org @@ -1,10 +1,13 @@ +#+TITLE: Design: Signal client in Emacs (forked signel) +#+DATE: 2026-05-26 +#+TODO: TODO | DONE +#+TODO: DRAFT READY DOING | IMPLEMENTED SUPERSEDED CANCELLED + +* DOING Design: Signal client in Emacs (forked signel) :PROPERTIES: :ID: 0cabd6ee-c458-47b5-a8af-3ee054b25821 -:STATUS: doing :END: -#+TITLE: Design: Signal client in Emacs (forked signel) -#+DATE: 2026-05-26 -#+STATUS: Draft +- 2026-07-04 Sat @ 15:30:41 -0500 — retrofitted to status-heading convention; keyword DOING from existing :STATUS: doing * Problem I want a Signal chat client inside Emacs: link it as a secondary device to my phone, pick a contact from my contact list, hold a text 1:1 conversation (read and send), and get a desktop notification on incoming messages, with an optional sound. Signal has no official API, so this is built on =signal-cli=, the mature headless CLI, driven over JSON-RPC. diff --git a/docs/specs/theme-studio-completion-preview-spec.org b/docs/specs/theme-studio-completion-preview-spec.org index 588f35a9..7d0c2608 100644 --- a/docs/specs/theme-studio-completion-preview-spec.org +++ b/docs/specs/theme-studio-completion-preview-spec.org @@ -1,7 +1,14 @@ #+TITLE: Theme Studio Minibuffer-Completion Preview — Spec #+AUTHOR: Craig Jennings #+DATE: 2026-06-23 -#+TODO: TODO | DONE SUPERSEDED CANCELLED +#+TODO: TODO | DONE +#+TODO: DRAFT READY DOING | IMPLEMENTED SUPERSEDED CANCELLED + +* DRAFT Theme Studio Minibuffer-Completion Preview — Spec +:PROPERTIES: +:ID: 2462f067-4c8d-4c33-a5be-54c0abc2eb1d +:END: +- 2026-07-04 Sat @ 15:30:41 -0500 — retrofitted to status-heading convention; keyword DRAFT from Metadata Status: Not ready, review found blockers * Metadata | Status | Not ready — first Codex review found implementation-readiness blockers (2026-06-23) | @@ -195,7 +202,7 @@ Add the caption naming minibuffer-prompt + highlight as living in UI Faces. When - Manual: open theme-studio in Chrome on the owner's inventory and confirm the Vertico section + baseline render, orderless/marginalia toggle, and vertico-current shows no background. * References / Appendix -- Reuse: [[file:theme-studio-preview-locate-spec.org][theme-studio-preview-locate-spec.org]] (hover/click locate), [[file:theme-studio-package-faces-spec-doing.org][theme-studio-package-faces-spec-doing.org]]. +- Reuse: [[file:theme-studio-preview-locate-spec.org][theme-studio-preview-locate-spec.org]] (hover/click locate), [[file:theme-studio-package-faces-spec.org][theme-studio-package-faces-spec.org]]. - Spike: /tmp completion-face-preview.el (verified render; not committed — informs this spec, not grown into it). - Live face values captured 2026-06-23 (WIP theme): minibuffer-prompt #899bb1/#100f0f bold; orderless-match-face-0..3 #cbd0d6 / #c99990 / #c5d4ae / #bea9dc bold italic; vertico-current inherits highlight (#eddba7 bold, no background). diff --git a/docs/specs/theme-studio-nerd-icons-colors-spec.org b/docs/specs/theme-studio-nerd-icons-colors-spec.org index c0f07b6d..94a5d178 100644 --- a/docs/specs/theme-studio-nerd-icons-colors-spec.org +++ b/docs/specs/theme-studio-nerd-icons-colors-spec.org @@ -1,7 +1,14 @@ #+TITLE: Theme-driven nerd-icons colors + theme-studio filetype legend — Spec #+AUTHOR: Craig Jennings & Claude #+DATE: 2026-06-23 -#+TODO: TODO | DONE SUPERSEDED CANCELLED +#+TODO: TODO | DONE +#+TODO: DRAFT READY DOING | IMPLEMENTED SUPERSEDED CANCELLED + +* READY Theme-driven nerd-icons colors + theme-studio filetype legend — Spec +:PROPERTIES: +:ID: 6df4e8a3-1fca-452a-9416-3fa0647b8dff +:END: +- 2026-07-04 Sat @ 15:30:41 -0500 — retrofitted to status-heading convention; keyword READY from Metadata Status: Ready pending Craig's go * Metadata | Status | Ready pending Craig's go — Codex review rounds 1-3 incorporated | diff --git a/docs/specs/theme-studio-package-faces-spec-doing.org b/docs/specs/theme-studio-package-faces-spec.org index 566f34db..4390f0fc 100644 --- a/docs/specs/theme-studio-package-faces-spec-doing.org +++ b/docs/specs/theme-studio-package-faces-spec.org @@ -1,10 +1,14 @@ -:PROPERTIES: -:ID: 8f37a1fd-cfd3-4b25-92e5-772468092bdc -:STATUS: doing -:END: #+TITLE: theme-studio — package faces (tier 3), starting with org-mode #+AUTHOR: Craig Jennings #+DATE: 2026-06-07 +#+TODO: TODO | DONE +#+TODO: DRAFT READY DOING | IMPLEMENTED SUPERSEDED CANCELLED + +* DOING theme-studio — package faces (tier 3), starting with org-mode +:PROPERTIES: +:ID: 8f37a1fd-cfd3-4b25-92e5-772468092bdc +:END: +- 2026-07-04 Sat @ 15:30:41 -0500 — retrofitted to status-heading convention; keyword DOING from existing :STATUS: doing * Status diff --git a/docs/specs/theme-studio-palette-generator-spec-doing.org b/docs/specs/theme-studio-palette-generator-spec.org index b98e1078..2d8fc5c6 100644 --- a/docs/specs/theme-studio-palette-generator-spec-doing.org +++ b/docs/specs/theme-studio-palette-generator-spec.org @@ -1,11 +1,14 @@ -:PROPERTIES: -:ID: 2df157b8-c7c1-47a9-b080-d9586c6f424c -:STATUS: doing -:END: #+TITLE: Theme Studio Palette Generator -- Spec #+AUTHOR: Craig Jennings #+DATE: 2026-06-14 -#+TODO: TODO | DONE SUPERSEDED CANCELLED +#+TODO: TODO | DONE +#+TODO: DRAFT READY DOING | IMPLEMENTED SUPERSEDED CANCELLED + +* DOING Theme Studio Palette Generator -- Spec +:PROPERTIES: +:ID: 2df157b8-c7c1-47a9-b080-d9586c6f424c +:END: +- 2026-07-04 Sat @ 15:30:41 -0500 — retrofitted to status-heading convention; keyword DOING from existing :STATUS: doing * Metadata | Status | doing | diff --git a/docs/specs/theme-studio-perceptual-color-metrics-spec-implemented.org b/docs/specs/theme-studio-perceptual-color-metrics-spec.org index 57a4c70b..233632a5 100644 --- a/docs/specs/theme-studio-perceptual-color-metrics-spec-implemented.org +++ b/docs/specs/theme-studio-perceptual-color-metrics-spec.org @@ -1,10 +1,14 @@ -:PROPERTIES: -:ID: 15db8ae3-fc14-49f3-9ed5-d5ff59790904 -:STATUS: implemented -:END: #+TITLE: theme-studio — perceptual color metrics (OKLCH, APCA, ΔE) #+AUTHOR: Craig Jennings #+DATE: 2026-06-08 +#+TODO: TODO | DONE +#+TODO: DRAFT READY DOING | IMPLEMENTED SUPERSEDED CANCELLED + +* IMPLEMENTED theme-studio — perceptual color metrics (OKLCH, APCA, ΔE) +:PROPERTIES: +:ID: 15db8ae3-fc14-49f3-9ed5-d5ff59790904 +:END: +- 2026-07-04 Sat @ 15:30:41 -0500 — retrofitted to status-heading convention; keyword IMPLEMENTED from existing :STATUS: implemented + -implemented filename (Craig's prior determination) * Status diff --git a/docs/specs/theme-studio-preview-locate-spec.org b/docs/specs/theme-studio-preview-locate-spec.org index dee27e8c..2f07d9dd 100644 --- a/docs/specs/theme-studio-preview-locate-spec.org +++ b/docs/specs/theme-studio-preview-locate-spec.org @@ -1,11 +1,14 @@ -:PROPERTIES: -:ID: fbcf0e20-1328-42b4-aa36-3401509e7816 -:STATUS: ready-pending-go -:END: #+TITLE: Theme Studio Preview Element Locate — Spec #+AUTHOR: Craig Jennings #+DATE: 2026-06-15 -#+TODO: TODO | DONE SUPERSEDED CANCELLED +#+TODO: TODO | DONE +#+TODO: DRAFT READY DOING | IMPLEMENTED SUPERSEDED CANCELLED + +* READY Theme Studio Preview Element Locate — Spec +:PROPERTIES: +:ID: fbcf0e20-1328-42b4-aa36-3401509e7816 +:END: +- 2026-07-04 Sat @ 15:30:41 -0500 — retrofitted to status-heading convention; keyword READY from existing :STATUS: ready-pending-go * Metadata | Status | Ready pending Craig's go — four reviews incorporated (Codex, 2026-06-23) | diff --git a/docs/specs/theme-studio-seeding-engine-spec-doing.org b/docs/specs/theme-studio-seeding-engine-spec.org index baf9f5b0..9e943b3b 100644 --- a/docs/specs/theme-studio-seeding-engine-spec-doing.org +++ b/docs/specs/theme-studio-seeding-engine-spec.org @@ -1,10 +1,14 @@ -:PROPERTIES: -:ID: b70b37f2-37df-4c8e-ac2f-1f20d12e33dd -:STATUS: doing -:END: #+TITLE: theme-studio — seeding engine (role table to guide-correct defaults) #+AUTHOR: Craig Jennings #+DATE: 2026-06-08 +#+TODO: TODO | DONE +#+TODO: DRAFT READY DOING | IMPLEMENTED SUPERSEDED CANCELLED + +* DOING theme-studio — seeding engine (role table to guide-correct defaults) +:PROPERTIES: +:ID: b70b37f2-37df-4c8e-ac2f-1f20d12e33dd +:END: +- 2026-07-04 Sat @ 15:30:41 -0500 — retrofitted to status-heading convention; keyword DOING from existing :STATUS: doing * Status @@ -317,7 +321,7 @@ response resolved; everything else was woven into the body as written. budget this engine executes. - =scripts/theme-studio/generate.py= — =CATS=, =UI_FACES=/=UIMAP=, =APPS= / =seedPkgmap=, =exportObj= (the target shape). -- =docs/specs/theme-studio-perceptual-color-metrics-spec-implemented.org= — the +- =docs/specs/theme-studio-perceptual-color-metrics-spec.org= — the =colormath.js= core that v1 OKLCH shade generation uses. * Review and iteration history diff --git a/docs/specs/theme-studio-semantic-theme-architecture-spec.org b/docs/specs/theme-studio-semantic-theme-architecture-spec.org index 01ef1902..cab75712 100644 --- a/docs/specs/theme-studio-semantic-theme-architecture-spec.org +++ b/docs/specs/theme-studio-semantic-theme-architecture-spec.org @@ -1,11 +1,14 @@ -:PROPERTIES: -:ID: fe980b12-451a-4d8b-a550-d99f9ec49f45 -:STATUS: not-started -:END: #+TITLE: Theme Studio Semantic Theme Architecture -- Spec #+AUTHOR: Craig Jennings #+DATE: 2026-06-14 -#+TODO: TODO | DONE SUPERSEDED CANCELLED +#+TODO: TODO | DONE +#+TODO: DRAFT READY DOING | IMPLEMENTED SUPERSEDED CANCELLED + +* DRAFT Theme Studio Semantic Theme Architecture -- Spec +:PROPERTIES: +:ID: fe980b12-451a-4d8b-a550-d99f9ec49f45 +:END: +- 2026-07-04 Sat @ 15:30:41 -0500 — retrofitted to status-heading convention; keyword DRAFT from existing :STATUS: not-started * Metadata | Status | not-started | @@ -257,7 +260,7 @@ Rollout should keep the current flat output path as the default and add a separa - Modus Themes source: [[https://github.com/protesilaos/modus-themes][github.com/protesilaos/modus-themes]] - Current converter: [[file:../scripts/theme-studio/build-theme.el][scripts/theme-studio/build-theme.el]] - Current Theme Studio README: [[file:../scripts/theme-studio/README.md][scripts/theme-studio/README.md]] -- Package-face model spec: [[id:8f37a1fd-cfd3-4b25-92e5-772468092bdc][theme-studio-package-faces-spec-doing.org]] +- Package-face model spec: [[id:8f37a1fd-cfd3-4b25-92e5-772468092bdc][theme-studio-package-faces-spec.org]] * Review and iteration history ** 2026-06-14 Sunday @ 14:37:00 -0500 -- Craig -- author diff --git a/docs/specs/theme-studio-structured-output-spec.org b/docs/specs/theme-studio-structured-output-spec.org index ad189b7e..10aea1a8 100644 --- a/docs/specs/theme-studio-structured-output-spec.org +++ b/docs/specs/theme-studio-structured-output-spec.org @@ -1,11 +1,14 @@ -:PROPERTIES: -:ID: eaac7707-ed05-43df-9e51-b17c1d672531 -:STATUS: not-started -:END: #+TITLE: Theme-Studio Structured Theme Output — Spec #+AUTHOR: Craig Jennings #+DATE: 2026-06-15 -#+TODO: TODO | DONE SUPERSEDED CANCELLED +#+TODO: TODO | DONE +#+TODO: DRAFT READY DOING | IMPLEMENTED SUPERSEDED CANCELLED + +* DRAFT Theme-Studio Structured Theme Output — Spec +:PROPERTIES: +:ID: eaac7707-ed05-43df-9e51-b17c1d672531 +:END: +- 2026-07-04 Sat @ 15:30:41 -0500 — retrofitted to status-heading convention; keyword DRAFT from existing :STATUS: not-started * Metadata | Status | not-started | diff --git a/docs/specs/utility-consolidation-spec-doing.org b/docs/specs/utility-consolidation-spec.org index b0a5fe2b..871295d7 100644 --- a/docs/specs/utility-consolidation-spec-doing.org +++ b/docs/specs/utility-consolidation-spec.org @@ -1,10 +1,14 @@ -:PROPERTIES: -:ID: fc2e3926-b4a1-4b45-92eb-20841e13f655 -:STATUS: doing -:END: #+TITLE: Design: Consolidate Shared Utility Helpers #+AUTHOR: Craig Jennings #+DATE: 2026-05-04 +#+TODO: TODO | DONE +#+TODO: DRAFT READY DOING | IMPLEMENTED SUPERSEDED CANCELLED + +* DOING Design: Consolidate Shared Utility Helpers +:PROPERTIES: +:ID: fc2e3926-b4a1-4b45-92eb-20841e13f655 +:END: +- 2026-07-04 Sat @ 15:30:41 -0500 — retrofitted to status-heading convention; keyword DOING from existing :STATUS: doing * Status @@ -295,7 +299,7 @@ Worked =system-lib.el= header: ;; Private helpers rename without alias when all call sites change in the ;; same commit. ;; -;; See also: docs/specs/utility-consolidation-spec-doing.org for design rationale. +;; See also: docs/specs/utility-consolidation-spec.org for design rationale. ;; ;;; Code: #+end_src @@ -332,7 +336,7 @@ Load shape: - =cj-cache.el= follows the first real cache consumer's layer, likely Layer 2 if modeline/agenda/refile remain eager or near-eager. - Coordinate every new topic library with - [[id:e1fd137e-e164-42f4-a658-f4d32fbe3228][init-load-graph-spec-doing.org]] before migrating its first consumer. + [[id:e1fd137e-e164-42f4-a658-f4d32fbe3228][init-load-graph-spec.org]] before migrating its first consumer. * Naming Rules @@ -785,7 +789,7 @@ Recommendation: design addendum proves the API can drive the alignment. - Then decide whether modeline's buffer-local cache can use the same library or should remain specialized. -- Phase 5 step 1 produces =docs/specs/cache-helper-design-spec-implemented.org=. Until that +- Phase 5 step 1 produces =docs/specs/cache-helper-design-spec.org=. Until that file exists, =cj-cache.el= must not be created. The addendum is the prerequisite for any cache extraction commit. @@ -906,7 +910,7 @@ Inventory artifact: - Treat the inventory as living documentation. Cleared high-priority candidates may move to Phase 2 before the whole inventory is complete. - This inventory is independent from the module-shape inventory maintained by - [[id:e1fd137e-e164-42f4-a658-f4d32fbe3228][init-load-graph-spec-doing.org]]. The two projects may walk the same files, but they + [[id:e1fd137e-e164-42f4-a658-f4d32fbe3228][init-load-graph-spec.org]]. The two projects may walk the same files, but they record different facts in separate artifacts. For each helper record: diff --git a/docs/specs/vterm-to-ghostel-migration-spec-implemented.org b/docs/specs/vterm-to-ghostel-migration-spec.org index 1be4fe22..f3d39d22 100644 --- a/docs/specs/vterm-to-ghostel-migration-spec-implemented.org +++ b/docs/specs/vterm-to-ghostel-migration-spec.org @@ -1,10 +1,14 @@ -:PROPERTIES: -:ID: b54c94a0-d762-4b41-afd7-cf5593ce6675 -:STATUS: implemented -:END: #+TITLE: Migration: vterm → ghostel (single terminal engine) #+AUTHOR: Craig Jennings #+DATE: 2026-06-04 +#+TODO: TODO | DONE +#+TODO: DRAFT READY DOING | IMPLEMENTED SUPERSEDED CANCELLED + +* IMPLEMENTED Migration: vterm → ghostel (single terminal engine) +:PROPERTIES: +:ID: b54c94a0-d762-4b41-afd7-cf5593ce6675 +:END: +- 2026-07-04 Sat @ 15:30:41 -0500 — retrofitted to status-heading convention; keyword IMPLEMENTED from existing :STATUS: implemented + -implemented filename (Craig's prior determination) * Status @@ -175,7 +179,7 @@ Audited file set. ** Docs (active references only — historical notes stay) - =todo.org= current task link (already updated to this -spec path). -- =docs/design/module-inventory.org=, =docs/specs/init-load-graph-spec-doing.org= — +- =docs/design/module-inventory.org=, =docs/specs/init-load-graph-spec.org= — update active =vterm-config= / =ai-vterm= references to the new names. ** Tests (~35 files) |
