diff options
| author | Craig Jennings <c@cjennings.net> | 2026-07-10 06:00:44 -0500 |
|---|---|---|
| committer | Craig Jennings <c@cjennings.net> | 2026-07-10 06:00:44 -0500 |
| commit | 6a193a6c4b36c6bae4a5e2f2a7a8e8b9a32aed71 (patch) | |
| tree | d329923709101137530fce16b91b54d2f6508469 | |
| parent | 55b85754d78f268907ad5fa5be886973bbef921d (diff) | |
| download | dotemacs-6a193a6c4b36c6bae4a5e2f2a7a8e8b9a32aed71.tar.gz dotemacs-6a193a6c4b36c6bae4a5e2f2a7a8e8b9a32aed71.zip | |
docs(spec): cancel the org workflow doctor, it has no job
A doctor that refuses to install anything buys nothing that isn't already there.
Every external binary is guarded at its point of use, with a message that names it: hugo-config guards hugo and the file-manager opener, org-webclipper guards pandoc, org-export-config guards zathura, and ox-pandoc guards itself upstream. Missing packages surface at load or first use. Path checks were the only new capability, and warning about them at startup contradicts the spec's own goal of keeping startup quiet, while an on-demand check nobody remembers to run is worth nothing.
The spec's Problem section rested on a premise nobody verified: that none of these dependencies was checked anywhere. It came from grepping for our own warn helper by name instead of reading the modules for the behavior. The body stays as written with the correction marked, and a postmortem records that the Reuse dimension named the helper that made the feature redundant, then dismissed it in one clause.
No code changed.
| -rw-r--r-- | docs/specs/2026-07-10-org-workflow-doctor-spec.org | 33 |
1 files changed, 31 insertions, 2 deletions
diff --git a/docs/specs/2026-07-10-org-workflow-doctor-spec.org b/docs/specs/2026-07-10-org-workflow-doctor-spec.org index 397897c3..b7f5db6c 100644 --- a/docs/specs/2026-07-10-org-workflow-doctor-spec.org +++ b/docs/specs/2026-07-10-org-workflow-doctor-spec.org @@ -4,14 +4,34 @@ #+TODO: TODO | DONE #+TODO: DRAFT READY DOING | IMPLEMENTED SUPERSEDED CANCELLED -* DRAFT Org workflow doctor +* CANCELLED Org workflow doctor :PROPERTIES: :ID: c0e06025-a3b8-4238-a9a0-07f9e55913f4 :END: +- 2026-07-10 Fri @ 05:58:00 -0500 — CANCELLED. The feature has no job. Craig asked what the doctor buys when it refuses to install anything, and the answer is nothing that isn't already there. Every external binary is already guarded at its point of use, with a clear message: hugo-config guards hugo and the file-manager opener, org-webclipper guards pandoc, org-export-config guards zathura, and ox-pandoc guards itself upstream (ox-pandoc.el:1533, 1970). Package availability surfaces at load or first use. Path checks were the only genuinely new capability, and a startup warning about a missing org-dir contradicts this spec's own goal of keeping startup quiet, while an on-demand check nobody remembers to run is worth roughly nothing. DRAFT -> CANCELLED. - 2026-07-10 Fri @ 00:29:10 -0500 — drafted. +* Postmortem + +The spec cleared spec-create's Phase 0 bar narrowly, and that was the signal to stop +and ask what the feature bought over the mechanisms already in the tree. It wasn't +taken. + +The =Reuse & lost opportunities= dimension exists to catch exactly this. It was +filled in, it named =cj/executable-find-or-warn=, and it dismissed the helper in one +clause for warning as a side effect. Warning as a side effect is the feature. The +dimension was answered without being used. + +Three claims in the surrounding audit came from grepping for a helper's *name* rather +than reading for the *behavior*, and all three were wrong: the org modules were said +not to guard their binaries when they guard them at the point of use, which is the +better place. Reading corrected the claim each time. + +The one real finding this line of work produced landed elsewhere and stands: ledger +buffers were never linted, fixed in 55b85754. + * Metadata -| Status | draft | +| Status | cancelled | |----------+----------------------------------------------------------| | Owner | Craig Jennings | |----------+----------------------------------------------------------| @@ -33,6 +53,15 @@ moment the user chose. * Problem / Context +#+begin_quote +*Correction, 2026-07-10.* The premise below is false and the body is left intact as +the record of the mistake. Every external binary *is* checked, at its point of use: +=hugo-config= guards hugo and the file-manager opener, =org-webclipper= guards +pandoc, =org-export-config= guards zathura, and =ox-pandoc= guards itself upstream. +The claim came from grepping for =cj/executable-find-or-warn= by name instead of +reading the modules for the behavior. See the Postmortem above. +#+end_quote + The Org workflow spans many modules, and each depends on some mix of a personal path (=org-dir=, =roam-dir=), an external binary (pandoc, hugo), and an optional package that loads lazily (=org-noter=, =org-web-tools=). None of those |
