[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10,"_11":12},"actionData","errors","root",{"_284":-5,"_287":288,"_289":290},"routes/shell",{"_164":165,"_283":-5,"_284":-5,"_285":286},"routes/repo",{"_156":-7,"_157":158,"_159":160,"_161":162,"_163":26,"_164":165,"_166":26,"_167":26,"_168":26,"_169":26,"_170":26,"_171":26,"_172":173,"_174":175,"_176":26,"_177":-7,"_178":-7,"_179":180,"_181":182,"_183":184,"_185":-5,"_186":187,"_188":189,"_190":191,"_192":193},"routes/repo.commit",{"_13":14,"_15":16,"_17":18},"commit",{"_127":22,"_132":133,"_134":135,"_136":137,"_138":139,"_140":-5,"_141":142,"_143":144},"diff",{"_19":20,"_21":22,"_23":24,"_25":26},"checks",[],"old","85c957da912282bef89d344042de8161c6d65eb0","new","389520a1c0c46bb32f1383f13d8b8c8c04cfaf9c","files",[27],"truncated",false,{"_28":29,"_19":30,"_21":31,"_32":33,"_34":35,"_36":37,"_38":39},"path","crates/tidy/src/markdown/handoff.md",{"_127":131,"_129":130},{"_127":128,"_129":130},"kind","text","add",7,"del",11,"hunks",[40,41],{"_42":90,"_44":91,"_46":90,"_48":49,"_50":92},{"_42":43,"_44":45,"_46":47,"_48":49,"_50":51},"aStart",60,"aLen",18,"bStart",59,"bLen",15,"ops",[52,53,54,55,56,57,58,59,60,61,62,63,64,65,66,67,68,69,70,71,72],{"_73":74,"_75":77},{"_73":74,"_75":89},{"_73":74,"_75":77},{"_73":36,"_75":88},{"_73":36,"_75":77},{"_73":36,"_75":87},{"_73":36,"_75":86},{"_73":36,"_75":77},{"_73":36,"_75":85},{"_73":34,"_75":84},{"_73":74,"_75":77},{"_73":74,"_75":83},{"_73":74,"_75":82},{"_73":74,"_75":81},{"_73":74,"_75":80},{"_73":74,"_75":77},{"_73":34,"_75":79},{"_73":34,"_75":77},{"_73":74,"_75":78},{"_73":74,"_75":77},{"_73":74,"_75":76},"tag","eq","line","`crates/mdtidy_napi` is a `cdylib` built with napi 3.16, napi-derive 3.7, and `@napi-rs/cli` 3.10.9.","","## napi-rs","With wrapping on, an atom keeps its line breaks as written and a code span over two lines is written from its parsed value. One edge differs from Prettier: after an atom whose last line is already past the width, mdtidy breaks before the next word and Prettier doesn't.","- `list/huge-first-number.md`: renumbering past 9 digits (`999999999.` becomes `1000000000.`, which isn't a list marker).","- `list/followed-by-indented-things.md`: a list item with a wide marker, followed by indented code.","- `ignore/top-level-range.md`: an ignore range at the top level doesn't settle after one pass.","- `blockquote/prose-wrap-always/encoded-newline.md`: an encoded newline (` `) in a quote.","Four of Prettier's fixtures (corpus D) still fail the semantics oracle, with the default options too:","These four D fixtures also fail with the default options:","- Filling can move a block HTML tag to the start of a line, where it opens an HTML block (`opens_block` in `wrap.rs` doesn't know HTML; `opener.rs` does).","- Joining lines inside inline HTML or a code span changes its content: the spaces after the line break collapse.","Found by corpora C and D. The first two show up only with `wrap: always` or `wrap: never`, and they are the only ones C hits.","## Known bugs that change meaning",38,16,[93,94,95,96,97,98,99,100,101,102,103,104,105,106,107,108,109,110,111,112],{"_73":74,"_75":77},{"_73":74,"_75":126},{"_73":74,"_75":125},{"_73":36,"_75":124},{"_73":34,"_75":123},{"_73":74,"_75":77},{"_73":74,"_75":122},{"_73":74,"_75":77},{"_73":74,"_75":121},{"_73":74,"_75":77},{"_73":36,"_75":120},{"_73":36,"_75":119},{"_73":36,"_75":118},{"_73":36,"_75":117},{"_73":34,"_75":116},{"_73":34,"_75":115},{"_73":34,"_75":114},{"_73":74,"_75":77},{"_73":74,"_75":113},{"_73":74,"_75":77},"Kept on purpose:","3. A code span over two lines in a list item or quote: Prettier writes the second line with no indent and no `>`. That still parses the same but reads worse, so it isn't planned.","2. Footnote definitions: Prettier keeps the text on the `[^1]:` line only for one paragraph that is on one line (or with `wrap: never`). Otherwise the text starts on the next line, indented 4.","1. Hugo and Liquid templates (bootstrap, most of what C still misses): Prettier parses `{{ }}` and `{% %}` as their own nodes, keeps the indents of their paragraph lines, and puts no blank line around them.","4. A code span over two lines in a list item or quote: Prettier writes the second line with no indent and no `>`. That still parses the same but reads worse, so it isn't planned.","3. Footnote definitions: Prettier keeps the text on the `[^1]:` line only for one paragraph that is on one line (or with `wrap: never`). Otherwise the text starts on the next line, indented 4.","2. Tables: Prettier doesn't pad a row with fewer cells than the header. A `|` inside a code span in a cell splits the cell in GFM, and the two tools write the pieces differently.","1. Hugo and Liquid templates (bootstrap): Prettier parses `{{ }}` and `{% %}` as their own nodes, keeps their paragraph lines as written, and puts no blank line around them.","Most files first. The rules are in Prettier's `src/language-markdown/print/` (`mdast.js`, `children.js`, `list.js`): read them before guessing.","## Known gaps against Prettier","- **Prettier**: the target is Prettier 3.9.10. `mise run oracle:prettier -- ... [--show ]` formats one copy with Prettier (cached in `target/oracle`), one with mdtidy, counts identical files, and sorts the differences by kind. It hands mdtidy every file by name, because the CLI skips hidden folders on purpose. Last result: A 870/872, B 2,140/2,142, C 3,415/3,466, D 273/310. The semantics oracle passes on A, B, and C; D fails only on the bugs listed below. `bun fmt` is close (8 misses, all inside code blocks) but it is not the reference.","- **Prettier**: the target is Prettier 3.9.10. `mise run oracle:prettier -- ... [--show ]` formats one copy with Prettier (cached in `target/oracle`), one with mdtidy, counts identical files, and sorts the differences by kind. It hands mdtidy every file by name, because the CLI skips hidden folders on purpose. Last result: A 870/872, B 2,140/2,142, C 3,412/3,466, D 272/310. The semantics oracle passes on A and B; C and D fail only on the bugs listed below. `bun fmt` is close (8 misses, all inside code blocks) but it is not the reference.","- **Speed**: `mise run bench:ab -- [--rev ] ...` builds the working tree and `` (HEAD by default, in a temporary worktree), times both checking the folders in both orders, and compares medians: means swing with machine load. Each fix on 2026-10-30 and 2026-11-01 was within noise; together they cost about 2–3% (about 38 to 39 ms on A + B).","- **Semantics**: `MDTIDY_CORPUS=[:...] mise run oracle:semantics`. Every output re-parses to the same events (adjacent text merged, soft breaks as spaces, whitespace collapsed) and settles after one pass. It runs the Prettier preset, the Preserve preset, `wrap: always` at width 40, and `wrap: never`. It caught every real bug so far: trust it over reading diffs. When a file fails, `mise run oracle:shrink -- [mdtidy options...]` removes lines while it still fails and prints the few that are left. The events it compares come from `tests/support/events.rs`, shared by the test and the `events` example.","oid","a2773a8","mode","100644","ad62c22","parents",[20],"author",{"_146":147,"_148":149,"_154":155},"committer",{"_146":147,"_148":149,"_154":155},"message","docs: update handoff\n\nWrap-mode meaning bugs and the table gap are fixed. Record the new\nmatch counts and the four fixture bugs left.","signature","subject","docs: update handoff","authors",[145],{"_146":147,"_148":149,"_150":151,"_152":153},"name","Luke Edwards","email","luke.edwards05@gmail.com","login","lukeed","avatarUrl","https://avatars.githubusercontent.com/u/5855893?v=4","time",1793547230,"documentNavigation","repo","lukeed/tidy","repoId","b2cac5cc-818f-4958-803a-7d401ccd9a90","ownerId","user:5855893","organization","site","nexthub","private","admin","settings","maintainer","triage","starred","stars",0,"watchers",1,"watching","pinned","notify","views",[239,240,241,242,243,244,245,246,247,248,249,250,251],"navigation",{"_179":180,"_200":201,"_202":203,"_204":205,"_206":207,"_208":209,"_73":210},"sources",[],"viewer","meta",{"_195":77,"_196":151,"_197":77,"_166":26,"_198":194,"_199":26,"_172":173,"_174":175},"branches",[194],"tags",[],"cloneUrl","https://git.nexthub.sh/lukeed/tidy.git","main","description","owner","section","head","empty","pins",[222,223,224],"documents",{"_219":220,"_221":173},"code",{"_216":217,"_218":173},"automations",{"_213":214,"_215":-5},"delivery",{"_211":173,"_212":-5},"W1_y18R9FUcyveBRlHeRXdVTtjo","releases","applications","workflows",2,"deployments","commits",350,"changes","counts",{},"total",{"_225":218,"_146":237,"_28":218,"_228":238,"_177":230,"_231":26,"_232":230,"_233":173},{"_225":234,"_146":235,"_28":234,"_228":236,"_177":230,"_231":26,"_232":230,"_233":173},{"_225":226,"_146":227,"_28":226,"_228":229,"_177":230,"_231":26,"_232":230,"_233":173},"id","issues","Issues","filters",{},true,"saved","pinnable","count","tasks","Tasks",{},"Changes",{},{"_225":218,"_146":237,"_28":218,"_228":282,"_177":230,"_231":26,"_232":230},{"_225":234,"_146":235,"_28":234,"_228":281,"_177":230,"_231":26,"_232":230},{"_225":226,"_146":227,"_28":226,"_228":280,"_177":230,"_231":26,"_232":230},{"_225":277,"_146":278,"_28":277,"_228":279,"_177":26,"_231":26,"_232":230},{"_225":274,"_146":275,"_28":274,"_228":276,"_177":26,"_231":26,"_232":230},{"_225":213,"_146":272,"_28":206,"_228":273,"_177":26,"_231":26,"_232":230},{"_225":215,"_146":269,"_28":270,"_228":271,"_177":26,"_231":26,"_232":230},{"_225":211,"_146":267,"_28":211,"_228":268,"_177":26,"_231":26,"_232":230},{"_225":263,"_146":264,"_28":265,"_228":266,"_177":26,"_231":26,"_232":230},{"_225":202,"_146":261,"_28":202,"_228":262,"_177":26,"_231":26,"_232":26},{"_225":258,"_146":259,"_28":258,"_228":260,"_177":26,"_231":26,"_232":26},{"_225":255,"_146":256,"_28":255,"_228":257,"_177":26,"_231":26,"_232":26},{"_225":252,"_146":253,"_28":252,"_228":254,"_177":26,"_231":26,"_232":26},"decisions","Decisions",{},"changelog","Changelog",{},"roadmap","Roadmap",{},"Documents",{},"activity","Activity","insights",{},"Releases",{},"Deployments","automations/deployments",{},"Workflows",{},"discussions","Discussions",{},"goals","Goals",{},{},{},{},"groups","user","agents",[],"now",1794727502685,"sidebar","expanded"]