[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10,"_11":12},"actionData","errors","root",{"_311":-5,"_314":315,"_316":317},"routes/shell",{"_191":192,"_310":-5,"_311":-5,"_312":313},"routes/repo",{"_183":-7,"_184":185,"_186":187,"_188":189,"_190":26,"_191":192,"_193":26,"_194":26,"_195":26,"_196":26,"_197":26,"_198":26,"_199":200,"_201":202,"_203":26,"_204":-7,"_205":-7,"_206":207,"_208":209,"_210":211,"_212":-5,"_213":214,"_215":216,"_217":218,"_219":220},"routes/repo.commit",{"_13":14,"_15":16,"_17":18},"commit",{"_154":22,"_159":160,"_161":162,"_163":164,"_165":166,"_167":-5,"_168":169,"_170":171},"diff",{"_19":20,"_21":22,"_23":24,"_25":26},"checks",[],"old","983c9b9fd039d23bdf047bb5b27e58d3d406844b","new","bbc20669fe2ba930262f3d254b2d298b8b5e58f4","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",{"_154":158,"_156":157},{"_154":155,"_156":157},"kind","text","add",14,"del",17,"hunks",[40],{"_41":42,"_43":44,"_45":42,"_46":47,"_48":49},"aStart",16,"aLen",42,"bStart","bLen",39,"ops",[50,51,52,53,54,55,56,57,58,59,60,61,62,63,64,65,66,67,68,69,70,71,72,73,74,75,76,77,78,79,80,81,82,83,84,85,86,87,88,89,90,91,92,93,94,95,96,97,98,99,100,101,102,103,104,105],{"_106":107,"_108":109},{"_106":107,"_108":153},{"_106":107,"_108":109},{"_106":36,"_108":152},{"_106":34,"_108":151},{"_106":107,"_108":150},{"_106":107,"_108":149},{"_106":107,"_108":148},{"_106":107,"_108":147},{"_106":107,"_108":146},{"_106":36,"_108":145},{"_106":34,"_108":144},{"_106":107,"_108":109},{"_106":107,"_108":143},{"_106":107,"_108":109},{"_106":36,"_108":142},{"_106":34,"_108":141},{"_106":107,"_108":109},{"_106":107,"_108":140},{"_106":36,"_108":139},{"_106":34,"_108":138},{"_106":34,"_108":137},{"_106":107,"_108":109},{"_106":107,"_108":136},{"_106":107,"_108":109},{"_106":36,"_108":135},{"_106":34,"_108":134},{"_106":107,"_108":109},{"_106":107,"_108":133},{"_106":36,"_108":132},{"_106":36,"_108":131},{"_106":36,"_108":130},{"_106":36,"_108":129},{"_106":36,"_108":128},{"_106":36,"_108":127},{"_106":36,"_108":126},{"_106":36,"_108":125},{"_106":36,"_108":124},{"_106":36,"_108":123},{"_106":36,"_108":122},{"_106":34,"_108":121},{"_106":34,"_108":120},{"_106":34,"_108":119},{"_106":34,"_108":118},{"_106":34,"_108":117},{"_106":34,"_108":116},{"_106":107,"_108":109},{"_106":107,"_108":115},{"_106":107,"_108":109},{"_106":107,"_108":114},{"_106":36,"_108":113},{"_106":34,"_108":112},{"_106":34,"_108":111},{"_106":107,"_108":109},{"_106":107,"_108":110},{"_106":107,"_108":109},"tag","eq","line","","## napi-rs","- Collapsing spaces and trimming code line ends apply to every preset, not only Prettier's: both are layout, like the whitespace mdtidy already trims.","- HTML blocks in a task item keep their indent. Prettier indents their lines after the first past the task box, and adds 4 more spaces on every pass.","- Leading whitespace before inline HTML at a paragraph start is dropped. pulldown-cmark reports it as a text event, CommonMark renders it as nothing, and the semantics oracle ignores whitespace-only text for that reason.","- Setext headings become ATX. Prettier 3.9 keeps setext.","Kept on purpose:","7. `isAligned` ignores Prettier's `hasIndentedCodeblock` case. The corpus doesn't hit it.","6. Footnote definitions with more than one line: Prettier starts the text on the next line, indented 4.","5. A code span over two lines in a list item or quote: Prettier writes the second line with no indent and no `>`.","4. A list item followed by a blank line: Prettier puts a blank line between all blocks in that item (`isLooseListItem` checks the item's last character).","3. Link destinations: Prettier prints them from the parsed URL: `()` becomes `(<>)`, `` becomes `z`, and a URL with parentheses gets `<…>`.","2. HTML blocks indented up to 3 spaces: Prettier keeps the indent.","12. `isAligned` ignores Prettier's `hasIndentedCodeblock` case. The corpus doesn't hit it.","11. Footnote definitions with more than one line: Prettier starts the text on the next line, indented 4.","10. A code span over two lines in a list item or quote: Prettier writes the second line with no indent and no `>`.","9. A list item followed by a blank line: Prettier puts a blank line between all blocks in that item (`isLooseListItem` checks the item's last character).","8. Link destinations: Prettier prints them from the parsed URL: `()` becomes `(<>)`, `` becomes `z`, and a URL with parentheses gets `<…>`.","7. Task list items: Prettier aligns continuation lines after `- [ ] `.","6. HTML blocks indented up to 3 spaces: Prettier keeps the indent.","5. Trailing whitespace in code blocks: Prettier removes it, even with embedded formatting off.","4. Consecutive link reference definitions: Prettier puts no blank line between them.","3. Runs of spaces or tabs in text: Prettier writes one space.","2. Code spans: Prettier picks the fewest backticks that work (`` ` ```ts ` `` over ``` `` ```ts `` ```).","1. HTML right after a paragraph or another HTML block: Prettier keeps them on adjacent lines. mdtidy adds a blank line.","Most files first. The rules are in Prettier's `src/language-markdown/print/` (`mdast.js`, `children.js`, `list.js`): read them before guessing. 113 of the misses are Bun's react-compiler `.expect.md` fixtures, all from the first gap.","Most files first. 113 of the misses are Bun's react-compiler `.expect.md` fixtures, all from the first gap.","## Known gaps against Prettier","- **Prettier**: the target is Prettier 3.9.10. Format one copy with `prettier --no-config --no-editorconfig --ignore-path= --embedded-language-formatting=off --write .` and another with `fd -H -e md -X mdtidy --write`, then count identical files. The CLI skips hidden folders on purpose, so give it every file by name. Last result: 865/872 and 2,027/2,142. `bun fmt` is close (8 misses, all inside code blocks) but it is not the reference.","- **Speed**: build the old and the new CLI, then time both with `hyperfine -N --warmup 20 --runs 60 ' --check'` in both orders. Compare medians: means swing with machine load. Each fix on 2026-10-30 was within noise, and together they cost about 2–3%.","- **Prettier**: the target is Prettier 3.9.10. Format one copy with `prettier --no-config --no-editorconfig --ignore-path= --embedded-language-formatting=off --write .` and another with `fd -H -e md -X mdtidy --write`, then count identical files. The CLI skips hidden folders on purpose, so give it every file by name. Last result: 856/872 and 2,016/2,145. `bun fmt` is close (8 misses, all inside code blocks) but it is not the reference.","- **Semantics**: `MDTIDY_CORPUS= cargo test -p mdtidy --release --test 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.","Both oracles live in the repo. Corpora don't: rebuild them with `git ls-files '*.md'` from any repos at hand. The 2026-10 runs used vite + storybook + shadcn-svelte (872 files) and starship + bun (2,142 files, without `node_modules`).","Both oracles live in the repo. Corpora don't: rebuild them with `git ls-files '*.md'` from any repos at hand. The 2026-10 runs used vite + storybook + shadcn-svelte (865 files) and starship + bun (2,147 files).","## Oracles","- **Prettier rules** (from `printer-markdown`): adjacent sibling lists alternate `-`/`*` and `.`/`)`, git-diff-friendly numbering, `isAligned` with tab width 2, `_` emphasis falling back to `*` next to a word or inside emphasis, `---` (or `***` inside a list), backtick fences one longer than any run inside, aligned tables that only compact under `wrap: never`, the block after `` on the very next line, code spans with the fewest backticks that no run inside matches, one space for each run of spaces in text, sibling definitions on adjacent lines, no trailing whitespace on code lines, and a task item's first paragraph indented past its box (`BOX`).","- **Prettier rules** (from `printer-markdown`): adjacent sibling lists alternate `-`/`*` and `.`/`)`, git-diff-friendly numbering, `isAligned` with tab width 2, `_` emphasis falling back to `*` next to a word or inside emphasis, `---` (or `***` inside a list), backtick fences one longer than any run inside, aligned tables that only compact under `wrap: never`, and the block after `` on the very next line.","- **Code blocks and front matter are buffered** for the `format_with` callback.","- **Paragraphs are buffered only when wrapping** (`wrap.rs`). A line never starts with something that opens a block (`opens_block`).","- **Blank lines inside and between list items follow the source** (`Gap::Source`, `blank()`), which is Prettier's `listItem.spread` rule. It also keeps list looseness by construction, so nothing tracks tightness.","- **Lookahead is a small buffer** (`Events`). It reads up to three ordered-list items for Prettier's numbering and alignment rules before the first item is written.","- **Containers are a prefix stack** (`Container`: quote, list item, footnote, indented code). A list item's marker replaces its indent on its first line.","- **Blocks are normalized, inlines are mostly copied.** Text, HTML, entities, escapes, images, and the `](...)` part of a link are written as source slices. A text event's range starts after a backslash escape, so the writer extends it back one byte (`writer.rs`, `Event::Text`). Text loses runs of spaces (`collapse`, which uses memchr so plain text costs no copy), code spans get their delimiters rewritten (`span`), and link text goes through the same path as other inline content (`Link`).","- **Blocks are normalized, inlines are copied.** Text, code spans, links, images, HTML, entities, and escapes are written as source slices. A text event's range starts after a backslash escape, so the writer extends it back one byte (`writer.rs`, `Event::Text`).","One pass over pulldown-cmark's offset events, writing straight into a `String`. No tree and no layout document. That is the whole speed story: keep it _streaming_.","oid","b0793e5","mode","100644","d195f63","parents",[20],"author",{"_173":174,"_175":176,"_181":182},"committer",{"_173":174,"_175":176,"_181":182},"message","docs: update handoff gaps\n\nFive gaps are fixed. Record the new match counts, the benchmark method,\nwhere Prettier's rules live, and two choices: HTML in task items keeps\nits indent, and the whitespace fixes apply to every preset.","signature","subject","docs: update handoff gaps","authors",[172],{"_173":174,"_175":176,"_177":178,"_179":180},"name","Luke Edwards","email","luke.edwards05@gmail.com","login","lukeed","avatarUrl","https://avatars.githubusercontent.com/u/5855893?v=4","time",1793410373,"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",[266,267,268,269,270,271,272,273,274,275,276,277,278],"navigation",{"_206":207,"_227":228,"_229":230,"_231":232,"_233":234,"_235":236,"_106":237},"sources",[],"viewer","meta",{"_222":109,"_223":178,"_224":109,"_193":26,"_225":221,"_226":26,"_199":200,"_201":202},"branches",[221],"tags",[],"cloneUrl","https://git.nexthub.sh/lukeed/tidy.git","main","description","owner","section","head","empty","pins",[249,250,251],"documents",{"_246":247,"_248":200},"code",{"_243":244,"_245":200},"automations",{"_240":241,"_242":-5},"delivery",{"_238":200,"_239":-5},"W1_y18R9FUcyveBRlHeRXdVTtjo","releases","applications","workflows",2,"deployments","commits",350,"changes","counts",{},"total",{"_252":245,"_173":264,"_28":245,"_255":265,"_204":257,"_258":26,"_259":257,"_260":200},{"_252":261,"_173":262,"_28":261,"_255":263,"_204":257,"_258":26,"_259":257,"_260":200},{"_252":253,"_173":254,"_28":253,"_255":256,"_204":257,"_258":26,"_259":257,"_260":200},"id","issues","Issues","filters",{},true,"saved","pinnable","count","tasks","Tasks",{},"Changes",{},{"_252":245,"_173":264,"_28":245,"_255":309,"_204":257,"_258":26,"_259":257},{"_252":261,"_173":262,"_28":261,"_255":308,"_204":257,"_258":26,"_259":257},{"_252":253,"_173":254,"_28":253,"_255":307,"_204":257,"_258":26,"_259":257},{"_252":304,"_173":305,"_28":304,"_255":306,"_204":26,"_258":26,"_259":257},{"_252":301,"_173":302,"_28":301,"_255":303,"_204":26,"_258":26,"_259":257},{"_252":240,"_173":299,"_28":233,"_255":300,"_204":26,"_258":26,"_259":257},{"_252":242,"_173":296,"_28":297,"_255":298,"_204":26,"_258":26,"_259":257},{"_252":238,"_173":294,"_28":238,"_255":295,"_204":26,"_258":26,"_259":257},{"_252":290,"_173":291,"_28":292,"_255":293,"_204":26,"_258":26,"_259":257},{"_252":229,"_173":288,"_28":229,"_255":289,"_204":26,"_258":26,"_259":26},{"_252":285,"_173":286,"_28":285,"_255":287,"_204":26,"_258":26,"_259":26},{"_252":282,"_173":283,"_28":282,"_255":284,"_204":26,"_258":26,"_259":26},{"_252":279,"_173":280,"_28":279,"_255":281,"_204":26,"_258":26,"_259":26},"decisions","Decisions",{},"changelog","Changelog",{},"roadmap","Roadmap",{},"Documents",{},"activity","Activity","insights",{},"Releases",{},"Deployments","automations/deployments",{},"Workflows",{},"discussions","Discussions",{},"goals","Goals",{},{},{},{},"groups","user","agents",[],"now",1794727500068,"sidebar","expanded"]