[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10,"_11":12},"actionData","errors","root",{"_555":-5,"_558":559,"_560":561},"routes/shell",{"_436":437,"_554":-5,"_555":-5,"_556":557},"routes/repo",{"_428":-7,"_429":430,"_431":432,"_433":434,"_435":26,"_436":437,"_438":26,"_439":26,"_440":26,"_441":26,"_442":26,"_443":26,"_444":445,"_446":42,"_447":26,"_448":-7,"_449":-7,"_450":451,"_452":453,"_454":455,"_456":-5,"_457":458,"_459":460,"_461":462,"_463":464},"routes/repo.commit",{"_13":14,"_15":16,"_17":18},"commit",{"_399":22,"_404":405,"_406":407,"_408":409,"_410":411,"_412":-5,"_413":414,"_415":416},"diff",{"_19":20,"_21":22,"_23":24,"_25":26},"checks",[],"old","3f028a2e79a51cd6849bf5d73ef8819c471adc71","new","084ae47515963f051a7bec52565e62aa6c9fdac7","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",{"_399":403,"_401":402},{"_399":400,"_401":402},"kind","text","add",90,"del",71,"hunks",[40],{"_41":42,"_43":44,"_45":42,"_46":47,"_48":49},"aStart",1,"aLen",99,"bStart","bLen",118,"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,110,111,112,113,114,115,116,117,118,119,120,121,122,123,124,125,126,127,128,129,130,131,132,133,134,135,136,137,138,139,140,141,142,143,144,145,146,147,148,149,150,151,152,153,154,155,156,157,158,159,160,161,162,163,164,165,166,167,168,169,170,171,172,173,174,175,176,177,178,179,180,181,182,183,184,185,186,187,188,189,190,191,192,193,194,195,196,197,198,199,200,201,202,203,204,205,206,207,208,209,210,211,212,213,214,215,216,217,218,219,220,221,222,223,224,225,226,227,228,229,230,231,232,233,234,235,236,237,238],{"_239":276,"_240":398},{"_239":276,"_240":246},{"_239":36,"_240":397},{"_239":34,"_240":396},{"_239":276,"_240":246},{"_239":36,"_240":395},{"_239":34,"_240":394},{"_239":276,"_240":246},{"_239":36,"_240":393},{"_239":36,"_240":392},{"_239":36,"_240":391},{"_239":36,"_240":390},{"_239":36,"_240":389},{"_239":36,"_240":388},{"_239":36,"_240":387},{"_239":36,"_240":386},{"_239":34,"_240":385},{"_239":276,"_240":246},{"_239":36,"_240":384},{"_239":34,"_240":383},{"_239":34,"_240":382},{"_239":34,"_240":381},{"_239":34,"_240":380},{"_239":34,"_240":379},{"_239":34,"_240":378},{"_239":34,"_240":377},{"_239":34,"_240":376},{"_239":34,"_240":375},{"_239":34,"_240":374},{"_239":276,"_240":246},{"_239":36,"_240":373},{"_239":34,"_240":372},{"_239":276,"_240":246},{"_239":36,"_240":371},{"_239":36,"_240":370},{"_239":36,"_240":369},{"_239":36,"_240":368},{"_239":36,"_240":367},{"_239":36,"_240":366},{"_239":36,"_240":365},{"_239":36,"_240":364},{"_239":36,"_240":363},{"_239":36,"_240":362},{"_239":36,"_240":361},{"_239":36,"_240":360},{"_239":36,"_240":359},{"_239":34,"_240":358},{"_239":276,"_240":246},{"_239":36,"_240":357},{"_239":34,"_240":356},{"_239":276,"_240":246},{"_239":36,"_240":355},{"_239":34,"_240":354},{"_239":276,"_240":246},{"_239":36,"_240":353},{"_239":36,"_240":352},{"_239":36,"_240":351},{"_239":36,"_240":350},{"_239":34,"_240":349},{"_239":34,"_240":348},{"_239":276,"_240":246},{"_239":36,"_240":347},{"_239":36,"_240":346},{"_239":36,"_240":345},{"_239":34,"_240":344},{"_239":276,"_240":246},{"_239":36,"_240":343},{"_239":34,"_240":342},{"_239":276,"_240":246},{"_239":36,"_240":341},{"_239":34,"_240":340},{"_239":276,"_240":246},{"_239":36,"_240":339},{"_239":34,"_240":338},{"_239":34,"_240":337},{"_239":34,"_240":336},{"_239":34,"_240":335},{"_239":34,"_240":334},{"_239":276,"_240":246},{"_239":36,"_240":333},{"_239":36,"_240":332},{"_239":36,"_240":331},{"_239":36,"_240":330},{"_239":34,"_240":329},{"_239":276,"_240":246},{"_239":36,"_240":328},{"_239":34,"_240":327},{"_239":276,"_240":246},{"_239":36,"_240":326},{"_239":34,"_240":325},{"_239":34,"_240":324},{"_239":276,"_240":246},{"_239":36,"_240":323},{"_239":36,"_240":322},{"_239":36,"_240":321},{"_239":36,"_240":320},{"_239":36,"_240":319},{"_239":36,"_240":318},{"_239":36,"_240":317},{"_239":36,"_240":316},{"_239":34,"_240":315},{"_239":276,"_240":246},{"_239":36,"_240":314},{"_239":34,"_240":313},{"_239":276,"_240":246},{"_239":36,"_240":312},{"_239":34,"_240":311},{"_239":34,"_240":310},{"_239":34,"_240":309},{"_239":34,"_240":308},{"_239":34,"_240":307},{"_239":34,"_240":306},{"_239":276,"_240":246},{"_239":36,"_240":305},{"_239":34,"_240":304},{"_239":276,"_240":246},{"_239":36,"_240":303},{"_239":34,"_240":302},{"_239":276,"_240":246},{"_239":36,"_240":301},{"_239":36,"_240":300},{"_239":36,"_240":299},{"_239":36,"_240":298},{"_239":36,"_240":297},{"_239":36,"_240":296},{"_239":36,"_240":295},{"_239":34,"_240":294},{"_239":34,"_240":293},{"_239":34,"_240":292},{"_239":34,"_240":291},{"_239":34,"_240":290},{"_239":34,"_240":289},{"_239":276,"_240":246},{"_239":36,"_240":288},{"_239":34,"_240":287},{"_239":276,"_240":246},{"_239":36,"_240":286},{"_239":34,"_240":285},{"_239":276,"_240":246},{"_239":36,"_240":284},{"_239":34,"_240":283},{"_239":276,"_240":246},{"_239":36,"_240":282},{"_239":34,"_240":281},{"_239":34,"_240":280},{"_239":34,"_240":279},{"_239":34,"_240":278},{"_239":34,"_240":277},{"_239":276,"_240":246},{"_239":36,"_240":275},{"_239":36,"_240":274},{"_239":36,"_240":273},{"_239":36,"_240":272},{"_239":36,"_240":271},{"_239":34,"_240":270},{"_239":34,"_240":246},{"_239":34,"_240":269},{"_239":34,"_240":246},{"_239":34,"_240":268},{"_239":34,"_240":267},{"_239":34,"_240":266},{"_239":34,"_240":265},{"_239":34,"_240":264},{"_239":34,"_240":263},{"_239":34,"_240":262},{"_239":34,"_240":261},{"_239":34,"_240":260},{"_239":34,"_240":259},{"_239":34,"_240":258},{"_239":34,"_240":257},{"_239":34,"_240":246},{"_239":34,"_240":256},{"_239":34,"_240":246},{"_239":34,"_240":255},{"_239":34,"_240":254},{"_239":34,"_240":253},{"_239":34,"_240":252},{"_239":34,"_240":251},{"_239":34,"_240":250},{"_239":34,"_240":249},{"_239":34,"_240":248},{"_239":34,"_240":246},{"_239":34,"_240":247},{"_239":34,"_240":246},{"_239":34,"_240":245},{"_239":34,"_240":244},{"_239":34,"_240":243},{"_239":34,"_240":242},{"_239":34,"_240":241},"tag","line","- **Keep the oracles as mise tasks** under a `markdown:` or `md:` prefix if tidy has its own `oracle:` tasks, and run `oracle:semantics` in CI on a small committed sample.","- **Move the corpus paths into one place** (a mise env var or a small config) instead of `/tmp`. They are lost on reboot today.","- **Keep `pulldown-cmark` pinned exactly** (`0.13.6`): its event ranges and the two tab bugs are part of mdtidy's behavior, and an upgrade needs the semantics and Prettier oracles run on all four corpora.","- **Make the tidy CLI call `mdtidy::format_with` directly** for `.md` and `.markdown` in the same walk, and send code fences back through tidy's other formatters with the callback, as starship does. Keep `mdtidy_cli` as a thin standalone binary only if Luke wants both.","- **Keep the three crates as they are**, as `crates/mdtidy`, `crates/mdtidy_cli`, and `crates/mdtidy_napi`, if tidy's layout allows it. Their names are the published names, and the scripts build `-p mdtidy_cli`.","","## What I would do in the merge","- **Repository URL**: `workspace.package.repository` is `https://github.com/lukeed/mdtidy`. Update it to tidy's.","- **Starship**: `starship/vendor/mdtidy` is a committed symlink to `/Users/lukee/repos/oss/mdtidy`, and starship's `ss_check` depends on `vendor/mdtidy/crates/mdtidy` by path. After the merge, point the symlink, or the path, at the new location, or starship stops building. Starship uses the Prettier preset, maps `lineBreaks: preserve` to `Wrap::Preserve` and `auto` to `Wrap::Always`, sets `ignore` to `starship-ignore`, and sends code fences and front matter back through its own formatters. Check its Markdown with `starship format --format minimal` after any change to defaults.","- **Release** (`.github/workflows/release.yml`, `workflow_dispatch` only): a matrix of 8 targets (macOS arm64 and x64, Linux gnu and musl on arm64 and x64, Windows arm64 and x64), with `--use-napi-cross` for Linux gnu (glibc 2.17) and `-x` (zig) for musl. The publish job runs `napi create-npm-dirs`, `napi artifacts`, and `napi pre-publish -t npm --no-gh-release`, then `npm publish`. It needs an `NPM_TOKEN` secret, because trusted publishing can't be set up before a package exists. Actions are pinned by SHA. There is no CI workflow for pushes or pull requests.","- **npm**: the napi crate's `package.json` is the published `mdtidy` package (Luke owns the name), ESM, built with `@napi-rs/cli` 3.10.9. `napi.binaryName` is `mdtidy`, and the platform packages take napi's default unscoped names (`mdtidy-darwin-arm64` and so on). `@mdtidy` on npm belongs to someone else. `repository.directory` is `crates/mdtidy_napi`: update it with the new path. `index.js`, `index.d.ts`, `*.node`, `artifacts/`, and `npm/` are generated and git-ignored.","- **Tests**: `crates/mdtidy/tests/format.rs` (rules), `semantics.rs` (the oracle, which skips without `MDTIDY_CORPUS`), `support/events.rs` (shared with `examples/events.rs`), `fixtures/`, `crates/mdtidy_cli/tests/cli.rs`, and `crates/mdtidy_napi/index.test.ts`.","- **Scripts**: `bench/run.ts`, `bench/ab.ts`, `oracle/*.ts`, and `oracle/divergences/`. They find the repo root from their own path and build `-p mdtidy_cli`; rename the package there if it changes.","- **mise tasks** (`mise.toml`): `build`, `build:napi`, `fmt`, `fmt:fix`, `clippy`, `test` (depends on `build:napi`), `check`, `bench`, `bench:ab`, `oracle:corpus`, `oracle:divergences`, `oracle:prettier`, `oracle:semantics`, `oracle:shrink`. Tools: Rust 1.98.0 with clippy and rustfmt, Bun 1.4.4. `[env] CARGO_TARGET_DIR = \"{{config_root}}/target\"` stops a starship shell's target dir from leaking in.","- **Crates**: `crates/mdtidy` (library, crates.io name `mdtidy`, free on 2026-10-30), `crates/mdtidy_cli` (binary `mdtidy`), `crates/mdtidy_napi` (`cdylib`, `publish = false`). The workspace pins Rust 1.98, edition 2024, MIT, `unsafe_code = \"deny\"` (napi's macros emit `unsafe`, so `forbid` breaks the build), Clippy `all = warn` with `-D warnings` in CI, and a release profile with `lto = \"fat\"`, `codegen-units = 1`, `strip = true`. Dependencies: `memchr`, `pulldown-cmark` 0.13.6 (no default features), `unicode-width`, `pico-args`, napi 3.16 and napi-derive 3.7.","## What the merge must carry over","- **Code style**: no comments except one-line ones; doc comments in Simplified Technical English. Commit subjects are conventional and under 28 characters, with the reason in the body.","- **File size**: keep each file under 800 lines. `writer/mod.rs` is at 799: split it before adding to it.","- **Definitions have no events**: pulldown-cmark lists one per label, so the gaps between blocks are parsed for the repeats it leaves out (`writer/define.rs`).","- **Wrapping** (`wrap.rs`, `writer/wiki.rs`): Prettier's `fill` with its word rules. A space beside Chinese or Japanese text breaks only next to markup. A line break between two wide characters (not Korean) joins with nothing, and one between Chinese or Japanese and Latin text joins as a space. Prettier's `[[wiki links]]` never break, and a paragraph whose text has `[[` and a later `]]` or wiki link keeps its text as written. Inline link text never breaks; reference link text does. A paragraph's first line is never a lone tag.","- **Liquid and Hugo** (`writer/liquid.rs`) are paragraph text to pulldown-cmark and blocks to Prettier. mdtidy keeps pulldown-cmark's reading and copies Prettier's layout where it is safe. Filling never breaks a Liquid tag.","- **Openers** (`opener.rs`): an indented continuation line never opens a block. A line that would open a quote, heading, or list joins the line before; a line of `=` or `-` gets a backslash; a fence, break, or block HTML tag keeps its indent at the top level. Wrapping never starts a line with something that opens a block: the space before it never breaks, as Prettier does for its own markers.","- **Front matter** is found by hand at the very start of the file, with Prettier's rule (`front.rs`). pulldown-cmark's metadata flags stay off, because they find front matter anywhere.","- **Ignore directives** (`directive.rs`): `` keeps the next block as written, `` to `` keeps a range at the top level only (as in Prettier), and `` at the top of a file (after front matter) keeps the whole file. Starship sets the name to `starship-ignore`.","- **Presets**: `Preset::Prettier` (the default) normalizes to Prettier's style: `-` bullets alternating with `*` in adjacent lists, `_` emphasis, `**` strong, git-diff-friendly numbering, `---` rules, backtick fences, setext headings kept, and `prettier-ignore`. `Preset::Preserve` keeps every marker as written and uses `mdtidy-ignore`. Collapsing spaces, trimming code line ends, keeping HTML beside a paragraph or HTML block, and keeping HTML indents apply to both presets: all are layout, and none changes meaning. Options parse from lowercase names with `FromStr` (`options.rs`), which the CLI and the Node binding share.","- **Blocks are normalized, inlines are copied**: text, HTML, entities, escapes, and image alt text are written from source slices. A text event's range starts after a backslash escape, so the writer extends it back one byte. Text loses runs of spaces (`collapse`), code spans get the fewest backticks that work (`span`), and link targets and definitions are written from their parsed values unless that would read differently.","- **Never change meaning**: every output must parse to the same events as its input and settle in one pass. Where copying Prettier would break that, mdtidy differs and records why in `divergences.md`.","- **Streaming**: one pass over pulldown-cmark's offset events, writing straight into a `String`, with no tree and no layout document. That is where the speed comes from. Lookahead is a small buffer (`Events::peek`). A top-level list is surveyed once (`writer/survey.rs`), so nested lists and items never read ahead again. Paragraphs are buffered only when wrapping (`wrap.rs`), and code blocks only for the `format_with` callback.","## Design decisions and invariants","The semantics oracle passes on all four. Library speed: about 54 ms single-threaded for A+B (9.9 MB).","- **The crates.io name `mdtidy`** was free on 2026-10-30. `mdfmt` is taken there by an abandoned crate.","- **Doc comments on `#[napi]` items** become `index.d.ts` JSDoc, and a `\\n` in them becomes a real line break. Keep examples free of escapes.","- **napi's macros emit `unsafe`**, so the workspace lint is `unsafe_code = \"deny\"`. `forbid` can't be overridden and breaks the build.","- **An untrusted `mise.toml` fails the `cd`** into the repo, and anything after it in a `&&` chain is skipped. Run `mise trust` once per checkout.","- **`CARGO_TARGET_DIR` leaks** from a starship shell into this repo, and builds land in starship's `target/`. `mise.toml` pins it to `{{config_root}}/target`; set it explicitly when running `cargo` outside mise.","eq","| never | 870 | 2,142 | 3,444 | 292 |","| always | 870 | 2,067 | 3,417 | 286 |","| preserve (default) | 871/872 | 2,141/2,142 | 3,456/3,466 | 303/310 |","|---|---|---|---|---|","| Wrap | A | B | C | D |","## Pitfalls","Files that match Prettier 3.9.10, by `--wrap`:","Starship formats with the Prettier preset. It maps `lineBreaks: preserve` to `Wrap::Preserve` and `auto` to `Wrap::Always`, sets `ignore` to `starship-ignore`, and sends code fences and front matter back through its own formatters. Changing a default here changes starship's output: check its Markdown with `starship format --format minimal` before committing there.","### Last results","`starship/vendor/mdtidy` is a committed symlink to `/Users/lukee/repos/oss/mdtidy`, and `ss_check` depends on `vendor/mdtidy/crates/mdtidy` by path. Changes here show up in starship's next build. A machine or CI without this repo at that path can't build starship until mdtidy is published.","D is Prettier's edge-case fixtures: don't rank gaps by it. C has many files in Chinese and Japanese, which test wrapping.","## Starship","| D | `/tmp/mdtidy-corpus/d` | `~/repos/oss/prettier`, only `tests/format` | 310 |","| C | `/tmp/mdtidy-corpus/c` | `~/repos/oss/{angular-html-parser,rolldown,jest,v,deno,deno_lint,oxc,prettier}`, `~/repos/testing/{bootstrap,everything-claude-code}` | 3,466 |","| B | `/tmp/mdtidy-bench/corpus/b` | `~/repos/oss/bun`, `~/repos/personal/starship.io/starship` | 2,142 |","| A | `/tmp/mdtidy-bench/corpus/a` | `~/repos/oss/{vite,storybook,shadcn-svelte}` | 872 |","|---|---|---|---|","| Corpus | Path used | Repos | Files |","- **Publishing, when Luke says so**: add an `NPM_TOKEN` secret first. Trusted publishing can't be set up for packages that don't exist yet. Luke owns `mdtidy` on npm.","- **Release**: `.github/workflows/release.yml`, run by hand. Each target builds in a matrix: macOS cross-compiles x64, Linux gnu uses `--use-napi-cross` (glibc 2.17), musl uses `-x` (zig), and Windows cross-compiles arm64. The publish job runs `napi create-npm-dirs`, `napi artifacts --output-dir artifacts`, and `napi pre-publish -t npm --no-gh-release`, which publishes every platform package and adds them to `optionalDependencies`. Then it publishes `mdtidy`. Both `napi artifacts` and `napi pre-publish` fail if any target is missing.","- **Package**: the crate's `package.json` is the published `mdtidy`, as in oxc's `napi/parser`. `napi.targets` lists macOS arm64/x64, Linux gnu and musl arm64/x64, and Windows arm64/x64. Platform packages take napi's default unscoped names (`mdtidy-darwin-arm64`). `@mdtidy` on npm belongs to someone else.","- **The callback** is `Function, Option>`, aliased as `Callback`. `FnArgs` spreads the tuple into three JS arguments; a bare tuple arrives as one array argument.","- **Typing**: each option field carries `#[napi(ts_type = \"'a' | 'b'\")]`. Both functions carry a hand-written `ts_args_type`, because napi's own signature for the callback is unreadable. Read `index.d.ts` after any change to `src/lib.rs`.","- **API**: `format(source, options?, code?)` and `check(source, options?)`. Options are camelCase strings and numbers, parsed with the library's `FromStr` impls, so an unknown value throws `unknown

docs: write final handoff