diff options
| author | Craig Jennings <c@cjennings.net> | 2026-05-30 16:13:52 -0500 |
|---|---|---|
| committer | Craig Jennings <c@cjennings.net> | 2026-05-30 16:13:52 -0500 |
| commit | 4b24597eee171ccbc5f5fd7067fdd52b87931986 (patch) | |
| tree | c622ddd4c7744f088b6500244e18cbf640c88e14 | |
| parent | 86326c1f2677484b2906d8142891e8d023ba803e (diff) | |
| download | rulesets-4b24597eee171ccbc5f5fd7067fdd52b87931986.tar.gz rulesets-4b24597eee171ccbc5f5fd7067fdd52b87931986.zip | |
chore(inbox): file lint-org false-positive bug, drop unfixable follow-ups
The wrap-up lint pass kept re-flagging two verbatim-asterisk misplaced-heading items (=** DONE= and =** Startup Pull Ordering= shown as verbatim references in prose) that aren't real misplaced headings and can't be fixed in todo.org. Filed a checker-bug report in the inbox to suppress that class going forward, and dropped the two unactionable items from lint-followups.org.
| -rw-r--r-- | inbox/2026-05-30-lint-org-verbatim-asterisk-false-positive.org | 25 | ||||
| -rw-r--r-- | inbox/lint-followups.org | 4 |
2 files changed, 25 insertions, 4 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 new file mode 100644 index 0000000..d47dde7 --- /dev/null +++ b/inbox/2026-05-30-lint-org-verbatim-asterisk-false-positive.org @@ -0,0 +1,25 @@ +#+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. diff --git a/inbox/lint-followups.org b/inbox/lint-followups.org deleted file mode 100644 index 88c33d7..0000000 --- a/inbox/lint-followups.org +++ /dev/null @@ -1,4 +0,0 @@ - -* 2026-05-30 lint-org follow-ups — todo.org -** TODO line 2370 — misplaced-heading — Possibly misplaced heading line -** TODO line 1717 — misplaced-heading — Possibly misplaced heading line |