[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10,"_11":12},"actionData","errors","root",{"_314":-5,"_317":318,"_319":320},"routes/shell",{"_196":197,"_313":-5,"_314":-5,"_315":316},"routes/repo",{"_189":-7,"_190":191,"_192":193,"_194":195,"_196":197,"_198":26,"_199":26,"_200":26,"_201":26,"_202":26,"_203":26,"_204":36,"_205":43,"_206":26,"_207":-7,"_208":-7,"_209":210,"_211":212,"_213":214,"_215":-5,"_216":217,"_218":219,"_220":221,"_222":223},"routes/repo.commit",{"_13":14,"_15":16,"_17":18},"commit",{"_161":22,"_165":166,"_167":168,"_169":170,"_171":172,"_173":-5,"_174":175,"_176":177},"diff",{"_19":20,"_21":22,"_23":24,"_25":26},"checks",[],"old","b553007d2eb7a2f3d6f0a64fe5e60878ac7a3844","new","2ef3a9ce8300185af49f47f47bd52cdcd565bf84","files",[27],"truncated",false,{"_28":29,"_19":-5,"_21":30,"_31":32,"_33":34,"_35":36,"_37":38},"path","crates/tidy/src/markdown/handoff.md",{"_161":162,"_163":164},"kind","text","add",65,"del",0,"hunks",[39],{"_40":36,"_41":36,"_42":43,"_44":34,"_45":46},"aStart","aLen","bStart",1,"bLen","ops",[47,48,49,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":33,"_113":160},{"_112":33,"_113":119},{"_112":33,"_113":159},{"_112":33,"_113":119},{"_112":33,"_113":158},{"_112":33,"_113":119},{"_112":33,"_113":157},{"_112":33,"_113":156},{"_112":33,"_113":155},{"_112":33,"_113":154},{"_112":33,"_113":153},{"_112":33,"_113":152},{"_112":33,"_113":151},{"_112":33,"_113":119},{"_112":33,"_113":150},{"_112":33,"_113":119},{"_112":33,"_113":149},{"_112":33,"_113":119},{"_112":33,"_113":148},{"_112":33,"_113":147},{"_112":33,"_113":146},{"_112":33,"_113":145},{"_112":33,"_113":144},{"_112":33,"_113":143},{"_112":33,"_113":142},{"_112":33,"_113":119},{"_112":33,"_113":141},{"_112":33,"_113":119},{"_112":33,"_113":140},{"_112":33,"_113":119},{"_112":33,"_113":139},{"_112":33,"_113":138},{"_112":33,"_113":119},{"_112":33,"_113":137},{"_112":33,"_113":119},{"_112":33,"_113":136},{"_112":33,"_113":135},{"_112":33,"_113":134},{"_112":33,"_113":133},{"_112":33,"_113":132},{"_112":33,"_113":119},{"_112":33,"_113":131},{"_112":33,"_113":119},{"_112":33,"_113":130},{"_112":33,"_113":119},{"_112":33,"_113":129},{"_112":33,"_113":128},{"_112":33,"_113":127},{"_112":33,"_113":126},{"_112":33,"_113":125},{"_112":33,"_113":124},{"_112":33,"_113":119},{"_112":33,"_113":123},{"_112":33,"_113":119},{"_112":33,"_113":122},{"_112":33,"_113":119},{"_112":33,"_113":121},{"_112":33,"_113":119},{"_112":33,"_113":120},{"_112":33,"_113":119},{"_112":33,"_113":118},{"_112":33,"_113":117},{"_112":33,"_113":116},{"_112":33,"_113":115},{"_112":33,"_113":114},"tag","line","- **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.","","## Pitfalls","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.","`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.","## Starship","- **Publishing, when Luke says so**: drop `private`, run `napi create-npm-dirs` for the per-platform packages, build each target in CI (a GitHub Actions matrix on the native runner per target), run `napi prepublish` to wire `optionalDependencies`, then publish the platform packages before `mdtidy`. The npm name `mdtidy` was free on 2026-10-30.","- **Package**: `package.json` is `\"private\": true` so nothing publishes by accident. Its `napi.targets` lists macOS arm64/x64, Linux gnu arm64/x64, and Windows x64.","- **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: add handoff