Tuner
tune scans the samples with every pack (preset all) and the dash check, with the dictionary off. It proposes changes only for categories in the target preset: --preset, else the preset in effect. Hits that the allow lists already cover do not count.
| Kind | Samples | Scanned as |
|---|---|---|
docs (default) | Prose files. A directory keeps prose files only. | Prose files |
reply | Chat messages. | Replies |
commit | Commit messages, one per file. | Commit messages |
gh | PR or issue bodies, one per file. | gh bodies |
comments | Source files. A directory keeps code files only. | Code comments |
| Signal in the samples | Change |
|---|---|
| A category fires in 2 or more samples, or at least once per 500 words | Adds the category to features.aiWriting.disablePatterns |
| A phrase category fires 2 or more times, always on the same phrase | Adds the phrase to features.aiWriting.allow |
| A statistical pack with a tunable threshold fires | Sets the threshold in features.aiWriting.options to the nearest value that every sample passes |
A statistical pack has fewer words than its minWords | Lists the pack as needing more words |
| A category fires once in one sample | Leaves it on and lists it under kept |
aiWriting is off and the samples have 300 words or more | Turns aiWriting on |
| Em dashes, while the dash check is on | Turns the dash check off |
| En dashes only, while the dash check is on | Sets features.emDash.enDash to false |
| No dashes in 1,000 words or more, while the dash check is off | Turns the dash check on |
Kind gh | Raises maxPrBodyParagraphs and maxPrBodySentences to the 90th percentile of the samples |
Kind comments | Raises maxCommentLines to the 90th percentile of the comment runs |
Each change comes with its reason and up to 3 quoted examples from the samples. --apply merges the change into the chosen layer: objects merge, lists gain the new items, and other values are replaced.