diff options
| author | Craig Jennings <c@cjennings.net> | 2026-07-11 02:14:11 -0500 |
|---|---|---|
| committer | Craig Jennings <c@cjennings.net> | 2026-07-11 02:14:49 -0500 |
| commit | b2aeaf6caea2c2ba7d27012e5f4f3999ff7c81e0 (patch) | |
| tree | 7dfd56ed50ad92a535b90caad1ae28e48b00e8d8 /inbox/PROCESSED-2026-07-09-1341-from-work-bug-data-loss-wrap-org-table-el-and.org | |
| parent | cfbabf1da65c5224a4e3c7302c71baa98935d0e4 (diff) | |
| download | rulesets-b2aeaf6caea2c2ba7d27012e5f4f3999ff7c81e0.tar.gz rulesets-b2aeaf6caea2c2ba7d27012e5f4f3999ff7c81e0.zip | |
chore: file processed inbox handoffs and add two backlog tasks
Diffstat (limited to 'inbox/PROCESSED-2026-07-09-1341-from-work-bug-data-loss-wrap-org-table-el-and.org')
| -rw-r--r-- | inbox/PROCESSED-2026-07-09-1341-from-work-bug-data-loss-wrap-org-table-el-and.org | 28 |
1 files changed, 28 insertions, 0 deletions
diff --git a/inbox/PROCESSED-2026-07-09-1341-from-work-bug-data-loss-wrap-org-table-el-and.org b/inbox/PROCESSED-2026-07-09-1341-from-work-bug-data-loss-wrap-org-table-el-and.org new file mode 100644 index 0000000..a128d0a --- /dev/null +++ b/inbox/PROCESSED-2026-07-09-1341-from-work-bug-data-loss-wrap-org-table-el-and.org @@ -0,0 +1,28 @@ +#+TITLE: BUG (data loss): wrap-org-table.el and lint-org.el corrupt o +#+SOURCE: from work +#+DATE: 2026-07-09 13:41:56 -0500 + +BUG (data loss): wrap-org-table.el and lint-org.el corrupt org example blocks. + +Both scripts scan for lines beginning with "|" and rewrite them as org tables. They do not skip #+begin_example / #+begin_src / #+begin_quote regions, so ASCII art using pipe characters gets mangled into tables. Both write to disk with no confirmation. + +Reproduced 2026-07-09 in the work project against an architecture doc containing an ASCII pipeline diagram that uses | and v as flow arrows: + + Before: After: + | | | + v |---| + v + +and a plain indented block became a bordered org table with |---| rules inserted between every line. + +Two separable defects: + +1. Table detection is line-based. Both helpers should use org-element-at-point (or org-in-block-p) to skip example/src/quote/verse blocks rather than matching /^\s*|/. + +2. lint-org.el mutates its input. Passing five files to it reformatted all five on disk -- one of them by 1949 lines. Its documented job is to report judgment items. A linter must not write. If the reformat is wanted, it belongs behind an explicit --fix flag. + +Impact: silent data loss on any org file that mixes tables and example blocks, which is most architecture docs. In this case the good content was already staged in git and was recoverable. It would not have been otherwise. + +No local fix attempted: .ai/scripts/ is rulesets-owned and the startup rsync would revert it. Filed as a task on the work side (Org-table helpers corrupt example blocks) so it is tracked there until the canonical fix lands. + +Suggested test: run wrap-org-table.el against a file containing a #+begin_example block whose lines start with "|" and assert the block is byte-identical afterward. |
