aboutsummaryrefslogtreecommitdiff
path: root/inbox
diff options
context:
space:
mode:
authorCraig Jennings <c@cjennings.net>2026-05-30 16:13:52 -0500
committerCraig Jennings <c@cjennings.net>2026-05-30 16:13:52 -0500
commit4b24597eee171ccbc5f5fd7067fdd52b87931986 (patch)
treec622ddd4c7744f088b6500244e18cbf640c88e14 /inbox
parent86326c1f2677484b2906d8142891e8d023ba803e (diff)
downloadrulesets-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.
Diffstat (limited to 'inbox')
-rw-r--r--inbox/2026-05-30-lint-org-verbatim-asterisk-false-positive.org25
-rw-r--r--inbox/lint-followups.org4
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