diff options
Diffstat (limited to 'inbox')
| -rw-r--r-- | inbox/2026-05-30-lint-org-verbatim-asterisk-false-positive.org | 25 |
1 files changed, 0 insertions, 25 deletions
diff --git a/inbox/2026-05-30-lint-org-verbatim-asterisk-false-positive.org b/inbox/2026-05-30-lint-org-verbatim-asterisk-false-positive.org deleted file mode 100644 index d47dde7..0000000 --- a/inbox/2026-05-30-lint-org-verbatim-asterisk-false-positive.org +++ /dev/null @@ -1,25 +0,0 @@ -#+TITLE: lint-org misplaced-heading verbatim-asterisk false positives -#+SOURCE: wrap-up lint pass (rulesets, self-filed) -#+DATE: 2026-05-30 - -* TODO [#B] lint-org: stop flagging unfixable verbatim-asterisk misplaced-heading items :tooling:bug: - -** The error -Every wrap-up lint pass on =todo.org= re-surfaces =misplaced-heading — Possibly misplaced heading line= judgment items for legitimate verbatim org markup inside prose. Current examples: -- =todo.org= line ~2369: the =** DONE= reference ("a level-2 task ... sits as =** DONE= under Open Work"). -- =todo.org= line ~1717: the =** Startup Pull Ordering= reference. - -These are intentional =...=-wrapped heading references in sentences, not actual misplaced headings. The content is correct, so they can't be fixed in =todo.org=, yet they reappend to =inbox/lint-followups.org= on every wrap and can never be actioned. - -** The rule / checker -=.ai/scripts/lint-org.el= (canonical =claude-templates/.ai/scripts/lint-org.el=), the =misplaced-heading= branch that classifies =** Foo= / =*** Foo= inside body prose as a judgment item (search =verbatim-asterisk= / =misplaced-heading= in the script). It currently appends these to the follow-ups file as actionable TODOs, but they're never actionable. - -** Requested fix -Per the principle that linting should not flag items that aren't fixable (Craig, 2026-05-30): -1. Suppress the verbatim-asterisk =misplaced-heading= class so =...=-wrapped asterisk markup is never surfaced — it's never a real misplaced heading. -2. More broadly, when lint hits a genuinely unfixable item, route a note to rulesets' inbox (this channel) rather than recurring it in the local =lint-followups.org=. Fixable items still get fixed or surfaced as before. - -Add a test to =test-lint-org.el= pinning that a ==** Foo== verbatim span in body prose produces no judgment. - -** Done this session -Cleared the two recurring items from =inbox/lint-followups.org=. They will recur on the next wrap until this checker change lands. |